SNIHostName 建構函式

定義

命名空間:

Javax.Net.Ssl

組件:

Mono.Android.dll

多載

SNIHostName(Byte[])	SNIHostName使用指定的編碼值建立 。
SNIHostName(String)	SNIHostName使用指定的主機名稱建立 。

SNIHostName(Byte[])

SNIHostName使用指定的編碼值建立 。

[Android.Runtime.Register(".ctor", "([B)V", "", ApiSince=24)]
public SNIHostName (byte[]? encoded);

[<Android.Runtime.Register(".ctor", "([B)V", "", ApiSince=24)>]
new Javax.Net.Ssl.SNIHostName : byte[] -> Javax.Net.Ssl.SNIHostName

參數

encoded

Byte[]

此伺服器名稱的編碼主機名

屬性

RegisterAttribute

備註

SNIHostName使用指定的編碼值建立 。

這個方法通常用來剖析所要求 SNI 延伸模組中的編碼名稱值。

根據 RFC 6066，主機名的編碼名稱值符合 StandardCharsets#US_ASCII規範。 不過，在舊版的 SNI 擴充功能中，編碼的主機名會使用 UTF-8 編碼來表示為位元組字串。 針對版本容錯的目的，這個方法允許自變數的 encoded charset 可以是 StandardCharsets#UTF_8，以及 StandardCharsets#US_ASCII。 IDN#toASCII(String) 用來將 encoded 自變數轉譯為 ASCII 相容編碼 （ACE） 主機名。

強烈建議使用此建構函式來剖析所要求 SNI 延伸模組中的編碼名稱值。 否則，若要遵守 RFC 6066，請一律使用StandardCharsets#US_ASCII符合規範的字元集，並針對主機名中的 ASCII 字元強制執行限制（請參閱 RFC 3490、RFC 1122、RFC 1123），encoded或改用 SNIHostName#SNIHostName(String) 。

如果encoded自變數是非法的：<ul><li>encoded 是空的，</li><li>encoded 結尾是尾端點，</li>encoded>< li 未編碼StandardCharsets#US_ASCII或StandardCharsets#UTF_8符合規範的 charset，</li li>><encoded 不是符合 RFC 3490 規格<的有效國際化域名 （IDN）。/li></ul>

請注意， encoded 會複製位元組陣列，以防止後續修改。

的 javax.net.ssl.SNIHostName.SNIHostName(byte[])Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

SNIHostName(String)

SNIHostName使用指定的主機名稱建立 。

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "", ApiSince=24)]
public SNIHostName (string? hostname);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "", ApiSince=24)>]
new Javax.Net.Ssl.SNIHostName : string -> Javax.Net.Ssl.SNIHostName

參數

hostname

String

此伺服器名稱的主機名

屬性

RegisterAttribute

備註

SNIHostName使用指定的主機名稱建立 。

請注意，根據 RFC 6066，主機名的編碼伺服器名稱值符合 StandardCharsets#US_ASCII規範。 在此方法中， hostname 可以是用戶易記的國際化功能變數名稱 （IDN）。 IDN#toASCII(String, int) 用來強制執行主機名中 ASCII 字元的限制（請參閱 RFC 3490、 RFC 1122、 RFC 1123），並將 轉譯 hostname 為 ASCII 相容編碼 （ACE），如下所示：

IDN.toASCII(hostname, IDN.USE_STD3_ASCII_RULES);

如果hostname自變數是非法的：<ul<>li>hostname 是空的，</li li<>hostname> 結尾為尾端點，</li li<>>hostname 不是符合 RFC 3490 規格的有效國際化功能變數名稱（IDN）。</li></ul>

的 javax.net.ssl.SNIHostName.SNIHostName(java.lang.String)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。