X509CertSelector.AddSubjectAlternativeName 方法

定義

命名空間:

Java.Security.Cert

組件:

Mono.Android.dll

多載

AddSubjectAlternativeName(Int32, Byte[])	將名稱新增至 subjectAlternativeNames 準則。
AddSubjectAlternativeName(Int32, String)	將名稱新增至 subjectAlternativeNames 準則。

AddSubjectAlternativeName(Int32, Byte[])

將名稱新增至 subjectAlternativeNames 準則。

[Android.Runtime.Register("addSubjectAlternativeName", "(I[B)V", "GetAddSubjectAlternativeName_IarrayBHandler")]
public virtual void AddSubjectAlternativeName (int type, byte[]? name);

[<Android.Runtime.Register("addSubjectAlternativeName", "(I[B)V", "GetAddSubjectAlternativeName_IarrayBHandler")>]
abstract member AddSubjectAlternativeName : int * byte[] -> unit
override this.AddSubjectAlternativeName : int * byte[] -> unit

參數

type

Int32

名稱類型 （0-8，如上所述）

name

Byte[]

位元組數位，包含 ASN.1 DER 編碼格式的名稱

屬性

RegisterAttribute

例外狀況

IOException

如果名稱譯碼失敗，則為 。

備註

將名稱新增至 subjectAlternativeNames 準則。 X509Certificate必須包含所有或至少一個指定的 subjectAlternativeNames，視 matchAllNames 旗標的值而定（請參閱 #setMatchAllSubjectAltNames setMatchAllSubjectAltNames）。

這個方法可讓呼叫端將名稱新增至主體別名集合。 指定的名稱會新增至 subjectAlternativeNames 準則的任何先前值。 如果指定的名稱重複，可能會忽略它。

名稱會以位元組陣列的形式提供。 這個位元組數位應該包含 DER 編碼名稱，因為它會出現在 RFC 5280 和 X.509 中定義的 GeneralName 結構中。 編碼的位元組數位應該只包含名稱的編碼值，而且不應該在 GeneralName 結構中包含與名稱相關聯的標記。 此結構的 ASN.1 定義會出現在下方。

{@code
             GeneralName ::= CHOICE {
                  otherName                       [0]     OtherName,
                  rfc822Name                      [1]     IA5String,
                  dNSName                         [2]     IA5String,
                  x400Address                     [3]     ORAddress,
                  directoryName                   [4]     Name,
                  ediPartyName                    [5]     EDIPartyName,
                  uniformResourceIdentifier       [6]     IA5String,
                  iPAddress                       [7]     OCTET STRING,
                  registeredID                    [8]     OBJECT IDENTIFIER}
            }

請注意，此處提供的位元組陣列會複製，以防止後續的修改。

的 java.security.cert.X509CertSelector.addSubjectAlternativeName(int, byte[])Java 檔。

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

AddSubjectAlternativeName(Int32, String)

將名稱新增至 subjectAlternativeNames 準則。

[Android.Runtime.Register("addSubjectAlternativeName", "(ILjava/lang/String;)V", "GetAddSubjectAlternativeName_ILjava_lang_String_Handler")]
public virtual void AddSubjectAlternativeName (int type, string? name);

[<Android.Runtime.Register("addSubjectAlternativeName", "(ILjava/lang/String;)V", "GetAddSubjectAlternativeName_ILjava_lang_String_Handler")>]
abstract member AddSubjectAlternativeName : int * string -> unit
override this.AddSubjectAlternativeName : int * string -> unit

參數

type

Int32

名稱類型 （0-8，如 RFC 5280，第 4.2.1.6 節中所指定）

name

String

字串格式的名稱 （不是 null）

屬性

RegisterAttribute

例外狀況

IOException

如果剖析名稱失敗，則為 。

備註

將名稱新增至 subjectAlternativeNames 準則。 X509Certificate必須包含所有或至少一個指定的 subjectAlternativeNames，視 matchAllNames 旗標的值而定（請參閱 #setMatchAllSubjectAltNames setMatchAllSubjectAltNames）。

這個方法可讓呼叫端將名稱新增至主體別名集合。 指定的名稱會新增至 subjectAlternativeNames 準則的任何先前值。 如果指定的名稱重複，可能會忽略它。

名稱是以字串格式提供。 RFC 822、DNS 和 URI 名稱會針對這些類型使用完善的字串格式（受限於 RFC 5280 中包含的限制）。 IPv4 位址名稱是使用虛線四元表示法來提供。 OID 位址名稱會以以句號分隔的非負整數序列表示。 而目錄名稱（辨別名稱）則以 RFC 2253 格式提供。 沒有針對 otherNames、X.400 名稱、EDI 合作物件名稱、IPv6 位址名稱或任何其他類型的名稱定義標準字串格式。 應該使用 #addSubjectAlternativeName(int type, byte [] name) addSubjectAlternativeName(int type, byte [] name) 方法指定它們。

<strong Note：</strong>> for distinguished names， use #addSubjectAlternativeName（int， byte[]） instead. 這個方法不應該依賴，因為它無法比對某些憑證，因為 RFC 2253 String 格式的編碼資訊遺失了一些辨別名稱。

的 java.security.cert.X509CertSelector.addSubjectAlternativeName(int, java.lang.String)Java 檔。

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