SNIHostName 构造函数
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| SNIHostName(Byte[]) |
使用指定的编码值创建一个 |
| SNIHostName(String) |
使用指定的主机名创建一个 |
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[]
此服务器名称的编码主机名
- 属性
注解
使用指定的编码值创建一个 SNIHostName 。
此方法通常用于分析所请求的 SNI 扩展中的编码名称值。
根据 RFC 6066，主机名的编码名称值符合 StandardCharsets#US_ASCII要求。 但是，在早期版本的 SNI 扩展（ RFC 4366）中，编码的主机名使用 UTF-8 编码表示为字节字符串。 出于版本容错的目的，此方法允许参数StandardCharsets#UTF_8的encoded字符集以及 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<>li>encoded 未编码StandardCharsets#US_ASCII或StandardCharsets#UTF_8符合字符集，</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
此服务器名称的主机名
- 属性
注解
使用指定的主机名创建一个 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 属性许可证中所述的术语使用。