X509CertSelector.SubjectAlternativeNames プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
subjectAlternativeNames 条件のコピーを返します。 または、subjectAlternativeNames 条件を設定します。
public virtual System.Collections.Generic.ICollection<System.Collections.Generic.IList<object>>? SubjectAlternativeNames { [Android.Runtime.Register("getSubjectAlternativeNames", "()Ljava/util/Collection;", "GetGetSubjectAlternativeNamesHandler")] get; [Android.Runtime.Register("setSubjectAlternativeNames", "(Ljava/util/Collection;)V", "GetSetSubjectAlternativeNames_Ljava_util_Collection_Handler")] set; }[<get: Android.Runtime.Register("getSubjectAlternativeNames", "()Ljava/util/Collection;", "GetGetSubjectAlternativeNamesHandler")>]
[<set: Android.Runtime.Register("setSubjectAlternativeNames", "(Ljava/util/Collection;)V", "GetSetSubjectAlternativeNames_Ljava_util_Collection_Handler")>]
member this.SubjectAlternativeNames : System.Collections.Generic.ICollection<System.Collections.Generic.IList<obj>> with get, setプロパティ値
名前の a Collection (または null)
- 属性
注釈
プロパティ getter のドキュメント:
subjectAlternativeNames 条件のコピーを返します。 には X509Certificate 、matchAllNames フラグの値に応じて、指定された subjectAlternativeNames のすべてまたは少なくとも 1 つが含まれている必要があります (「」を参照 #getMatchAllSubjectAltNames getMatchAllSubjectAltNames)。 返される値が のnull場合、subjectAlternativeNames チェックは実行されません。
返される値が でない null場合は、 Collection サブジェクトの別名条件に含める名前ごとに 1 つのエントリを持つ です。 各エントリは、 List 最初のエントリが である (名前の種類が Integer 0 から 8) で、2 番目のエントリが String または バイト配列 (それぞれ文字列または ASN.1 DER でエンコードされた形式の名前) である です。 同じ型の複数の名前を指定できます。 返される には Collection 、重複する名前 (同じ名前と名前の種類) が含まれている可能性があることに注意してください。
内の Collection 各サブジェクトの別名は、 または String として ASN.1 でエンコードされたバイト配列として指定できます。 使用される形式の詳細については、 と #addSubjectAlternativeName(int type, byte [] name) addSubjectAlternativeName(int type, byte [] name)を参照してください#addSubjectAlternativeName(int type, String name) addSubjectAlternativeName(int type, String name)。
後続の変更から保護するために、 Collection に対してディープ コピーが実行されることに注意してください。
の Java ドキュメント java.security.cert.X509CertSelector.getSubjectAlternativeNames()。
プロパティ セッターのドキュメント:
subjectAlternativeNames 条件を設定します。 には X509Certificate 、matchAllNames フラグの値に応じて、指定された subjectAlternativeNames のすべてまたは少なくとも 1 つが含まれている必要があります (「」を参照 #setMatchAllSubjectAltNames setMatchAllSubjectAltNames)。
このメソッドを使用すると、呼び出し元は、1 つのメソッド呼び出しで subjectAlternativeNames 条件のサブジェクトの別名の完全なセットを指定できます。 指定した値は、subjectAlternativeNames 条件の前の値を置き換えます。
namesパラメーター (そうでないnull場合) は、Collectionサブジェクトの別名条件に含める名前ごとに 1 つのエントリを持つ です。 各エントリは、 List 最初のエントリが である (名前の種類が Integer 0 から 8) で、2 番目のエントリが String または バイト配列 (それぞれ文字列または ASN.1 DER でエンコードされた形式の名前) である です。 同じ型の複数の名前を指定できます。 がこの引数の値として指定されている場合null、subjectAlternativeNames チェックは実行されません。
内の Collection 各サブジェクトの別名は、 または String として ASN.1 でエンコードされたバイト配列として指定できます。 使用される形式の詳細については、 と #addSubjectAlternativeName(int type, byte [] name) addSubjectAlternativeName(int type, byte [] name)を参照してください#addSubjectAlternativeName(int type, String name) addSubjectAlternativeName(int type, String name)。
<strong>Note:</strong> for distinguished names, specify the byte array form instead of the String form. 詳細については、 の #addSubjectAlternativeName(int, String) メモを参照してください。
パラメーターにはnames重複する名前 (同じ名前と名前の種類) を含めることができますが、 メソッドによって#getSubjectAlternativeNames getSubjectAlternativeNames返される名前の からCollection削除される可能性があることに注意してください。
後続の変更から保護するために、 Collection に対してディープ コピーが実行されることに注意してください。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。