TrustAnchor 建構函式

定義

命名空間:: Java.Security.Cert

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
TrustAnchor(X509Certificate, Byte[])	建立一個帶有指定`X509Certificate`且可選名稱約束的實例`TrustAnchor`，這些限制旨在作為驗證 X 的額外約束。
TrustAnchor(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。
TrustAnchor(X500Principal, IPublicKey, Byte[])	建立一個實例，將 `TrustAnchor` 最受信任的 CA 指定為 X500Principal 與公開金鑰。
TrustAnchor(String, IPublicKey, Byte[])	建立一個實例，將 `TrustAnchor` 最受信任的 CA 指定為區別名稱與公鑰。

TrustAnchor(X509Certificate, Byte[])

建立一個帶有指定X509Certificate且可選名稱約束的實例TrustAnchor，這些限制旨在作為驗證 X 的額外約束。

[Android.Runtime.Register(".ctor", "(Ljava/security/cert/X509Certificate;[B)V", "")]
public TrustAnchor(Java.Security.Cert.X509Certificate? trustedCert, byte[]? nameConstraints);

[<Android.Runtime.Register(".ctor", "(Ljava/security/cert/X509Certificate;[B)V", "")>]
new Java.Security.Cert.TrustAnchor : Java.Security.Cert.X509Certificate * byte[] -> Java.Security.Cert.TrustAnchor

參數

trustedCert: X509Certificate

一個值得信賴的 X509Certificate

nameConstraints: Byte[]

一個位元組陣列，包含 NameConstraints 擴充的 ASN.1 DER 編碼，用於檢查名稱約束。只有擴展值被包含，沒有 OID 或臨界性旗標。指定 null 省略參數。

屬性: RegisterAttribute

例外狀況

IllegalArgumentException

如果名稱約束的解碼失敗。

備註

建立一個帶有指定X509Certificate且可選名稱約束的實例TrustAnchor，這些限制用於驗證 X.509 認證路徑時作為額外限制。

名稱約束以位元組陣列形式指定。此位元組陣列應包含 DER 編碼的名稱約束形式，如同 RFC 5280 與 X.509 定義的 NameConstraints 結構中所呈現。 ASN.1 對此結構的定義如下。

{@code
             NameConstraints ::= SEQUENCE {
                  permittedSubtrees       [0]     GeneralSubtrees OPTIONAL,
                  excludedSubtrees        [1]     GeneralSubtrees OPTIONAL }

             GeneralSubtrees ::= SEQUENCE SIZE (1..MAX) OF GeneralSubtree

             GeneralSubtree ::= SEQUENCE {
                  base                    GeneralName,
                  minimum         [0]     BaseDistance DEFAULT 0,
                  maximum         [1]     BaseDistance OPTIONAL }

             BaseDistance ::= INTEGER (0..MAX)

             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 文件 java.security.cert.TrustAnchor.TrustAnchor(java.security.cert.X509Certificate, byte[])。

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

適用於

TrustAnchor(IntPtr, JniHandleOwnership)

建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。

protected TrustAnchor(IntPtr javaReference, Android.Runtime.JniHandleOwnership transfer);

new Java.Security.Cert.TrustAnchor : nativeint * Android.Runtime.JniHandleOwnership -> Java.Security.Cert.TrustAnchor

參數

javaReference: IntPtr
nativeint

IntPtrA 包含一個 Java 原生介面（JNI）物件參考。

transfer: JniHandleOwnership

JniHandleOwnershipA 指示如何處理javaReference

備註

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

適用於

TrustAnchor(X500Principal, IPublicKey, Byte[])

建立一個實例，將 TrustAnchor 最受信任的 CA 指定為 X500Principal 與公開金鑰。

[Android.Runtime.Register(".ctor", "(Ljavax/security/auth/x500/X500Principal;Ljava/security/PublicKey;[B)V", "")]
public TrustAnchor(Javax.Security.Auth.X500.X500Principal? caPrincipal, Java.Security.IPublicKey? pubKey, byte[]? nameConstraints);

[<Android.Runtime.Register(".ctor", "(Ljavax/security/auth/x500/X500Principal;Ljava/security/PublicKey;[B)V", "")>]
new Java.Security.Cert.TrustAnchor : Javax.Security.Auth.X500.X500Principal * Java.Security.IPublicKey * byte[] -> Java.Security.Cert.TrustAnchor

參數

caPrincipal: X500Principal

最受信任的 CA 名稱為 X500Principal

pubKey: IPublicKey

最受信任CA的公鑰

nameConstraints: Byte[]

一個位元組陣列，包含 NameConstraints 擴充的 ASN.1 DER 編碼，用於檢查名稱約束。只有擴展值被包含，沒有 OID 或臨界性旗標。指定 null 省略參數。

屬性: RegisterAttribute

例外狀況

IllegalArgumentException

若解碼名稱約束失敗。

備註

建立一個實例，將 TrustAnchor 最受信任的 CA 指定為 X500Principal 與公開金鑰。名稱限制是可選參數，旨在作為驗證 X.509 認證路徑時的額外限制。

名稱約束以位元組陣列形式指定。此位元組陣列包含 DER 編碼的名稱約束形式，與 RFC 5280 與 X.509 定義的 NameConstraints 結構相同。此結構的 ASN.1 符號可在文件 #TrustAnchor(X509Certificate, byte[]) TrustAnchor(X509Certificate trustedCert, byte[] nameConstraints) 中提供。

請注意，這裡提供的位元組陣列名稱是克隆的，以防後續修改。

已在1.5中新增。

Java 文件 java.security.cert.TrustAnchor.TrustAnchor(javax.security.auth.x500.X500Principal, java.security.PublicKey, byte[])。

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

適用於

TrustAnchor(String, IPublicKey, Byte[])

建立一個實例，將 TrustAnchor 最受信任的 CA 指定為區別名稱與公鑰。

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/security/PublicKey;[B)V", "")]
public TrustAnchor(string? caName, Java.Security.IPublicKey? pubKey, byte[]? nameConstraints);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/security/PublicKey;[B)V", "")>]
new Java.Security.Cert.TrustAnchor : string * Java.Security.IPublicKey * byte[] -> Java.Security.Cert.TrustAnchor