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 を使用できません。
注釈
Query、Fragment、Scheme、UserInfo、Host、Port、およびPathの各コンポーネントには、区切り記号は含まれません。 KeepDelimiter フラグ (ビットごとの OR 演算子を使用) をこれらの値と組み合わせて、区切り記号で値を取得できます。 他のすべての UriComponents 値と値の組み合わせについては、区切り記号が戻り値に含まれます。
コンポーネントは、URI に表示される順序で返されます。 たとえば、 Scheme を指定すると、最初に表示されます。
国際リソース識別子 (IRI) と国際化ドメイン名 (IDN) のサポートを有効にすると、 String で返される文字数が増えます。 IRI をサポートするために使用される Punycode 名には ASCII 文字のみが含まれ、常に xn-- プレフィックスで始まります。 IRI と IDN が有効になっている場合、Unicode サロゲート文字は GetComponents メソッドによって正しく処理されます。
IRI サポートの詳細については、 Uri クラスの「解説」セクションを参照してください。
Note
GetComponentsを format に設定してUnescaped メソッドが呼び出された場合、戻り値を Uri コンストラクターの引数として使用して同等のUriを作成することはできません。
