Uri.GetComponents(UriComponents, UriFormat) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した特殊文字エスケープを使用して、現在のインスタンスの指定した構成要素を取得します。
public:
System::String ^ GetComponents(UriComponents components, UriFormat format);public string GetComponents (UriComponents components, UriFormat format);member this.GetComponents : UriComponents * UriFormat -> stringPublic Function GetComponents (components As UriComponents, format As UriFormat) As Stringパラメーター
- components
- UriComponents
現在のインスタンスの中で呼び出し元に返す部分を指定する UriComponents 値のビットごとの組み合わせ。
- format
- UriFormat
特殊文字のエスケープ方法を制御する列挙値の 1 つ。
戻り値
現在のインスタンスの構成要素。
例外
components が、有効な UriComponents 値の組み合わせではありません。
現在の Uri が絶対 URI ではありません。 相対 URI は、このメソッドでは使用できません。
注釈
、QueryFragment、Scheme、UserInfo、HostPortおよびPathコンポーネントには区切り記号は含まれません。 フラグ ( KeepDelimiter ビットごとの OR 演算子を使用) とこれらの値のいずれかを組み合わせて、区切り記号を使用して値を取得できます。 その他 UriComponents のすべての値と値の組み合わせについては、区切り記号が戻り値に含まれます。
コンポーネントは、URI に表示される順序で返されます。 たとえば、指定した場合 Scheme 、最初に表示されます。
国際リソース識別子 (IRI) と国際化ドメイン名 (IDN) のサポートを有効にすると、返される文字数が String 増加します。 IRI をサポートするために使用される Punycode 名には ASCII 文字のみが含まれ、常に xn-- プレフィックスで始まります。 IRI と IDN が有効になっている場合、Unicode サロゲート文字はメソッドによって GetComponents 正しく処理されます。
IRI サポートの詳細については、クラスの「解説」セクションを Uri 参照してください。
注意
メソッドが GetComponents set to Unescaped でformat呼び出された場合、コンストラクターの引数として戻り値を使用してUri同等Uriの値を作成することはできません。