TLS 系統預設版本包含在.NET Framework 2.0 SP2，Windows Vista SP2 和 Server 2008 SP2 的支援

解決方案

開發人員指南

新的擴充功能的定義位於下列檔案：

• SecurityProtocolTypeExtensions.csnamespace System.Net{using System.Security.Authentication;public static class SecurityProtocolTypeExtensions{public const SecurityProtocolType Tls12 = (SecurityProtocolType)SslProtocolsExtensions.Tls12;public const SecurityProtocolType Tls11 = (SecurityProtocolType)SslProtocolsExtensions.Tls11;public const SecurityProtocolType SystemDefault = (SecurityProtocolType)0;}}

• SslProtocolsExtensions.csnamespace System.Security.Authentication{public static class SslProtocolsExtensions{public const SslProtocols Tls12 = (SslProtocols)0x00000C00;public const SslProtocols Tls11 = (SslProtocols)0x00000300;}}

若要包含的 TLS v1.2 支援，包含原始程式檔在專案中，並使用下列方法，以設定的通訊協定版本：

• 使用 ServicePointManager 為基礎的 Api 的應用程式可以使用 following:System.Net.ServicePointManager.SecurityProtocol，設定通訊協定 = SecurityProtocolTypeExtensions.Tls12;

• 使用SslStream AuthenticateAsClient （字串，X509CertificateCollection，SslProtocols，布林值）多載的應用程式可以設定成SslProtocolsExtensions.的SslProtocols值Tls12.

如果設定的第一段所述的登錄設定，而且SslProtocols值設為SslProtocols.None應用程式中，系統預設行為選擇，取決於 Windows 版本。此外，當您變更應用程式程式碼，來啟用.NET Framework 3.5 sp1 的 TLS v1.2 支援時，您應該要確定您解決下列的例外狀況，在沒有部署此更新程式所在的電腦上項目：

1. 如果未安裝 hotfix， ServicePointManager-根據的 Api (HTTP 或 FTP，SMTP) 將會擲回 「System.NotSupportedException： 不支援要求的安全性通訊協定"當應用程式會呼叫ServicePointManager.SecurityProtocol若要設定新的值。

2. 如果未安裝 hotfix， SslStream為基礎的 Api 會擲回例外狀況，當它們呼叫 AuthenticateAs * Api 其中一種方法：

   System.ArgumentException： 指定的值是無效的 'SslProtocolType' 的列舉型別中。參數名稱： sslProtocolType

注意為SslStream ， Tls12， Tls11與任何現有的Tls， Ssl3， Ssl2的組合 (例如： Tls12 |Tls11 |Tls) 會以無訊息模式會降級為現有的通訊協定 (例如： Tls) 沒有此補充程式的系統上。 要連線到 Tls 而不擲回例外狀況。

其他相關資訊

若要啟用 TLS v1.1 或 v1.2，做為作業系統的預設值，請依照下列的指示，在https://technet.microsoft.com/en-us/library/dn786418(v=ws.11).aspx#BKMK_SchannelTR_TLS12.注意： TLS v1.1 和 v1.2 並非適用於 Windows Vista 或 Windows 伺服器的 2008.If，您必須停用作業系統預設值由是 < 解決方案=""> 一節所述特定的應用程式，您可以藉由新增的登錄機碼設定下列的登錄機碼：HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node\]Microsoft\.NETFramework\v2.0.50727\System.Net.ServicePointManager.SystemDefaultTlsVersions<<Full path of the .exe for the file>> DWORD 0C:\MyApp\MyApp.exe DWORD 0

如需 TLS v1.2 的詳細資訊，請參閱引入 TLS v1.2。啟用SystemDefaultTlsVersions .NET 的登錄機碼之後下, 表所示，每個版本的 Windows 上時就會發生不同的行為。