Uri Uri Uri Uri Constructors

定義

オーバーロード

Uri(String) Uri(String) Uri(String) Uri(String)

指定した URI を使用して、Uri クラスの新しいインスタンスを初期化します。

Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext)

SerializationInfo クラスと StreamingContext クラスの指定したインスタンスから、Uri クラスの新しいインスタンスを初期化します。

Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean)

指定した URI を使用し、明示的な文字エスケープ制御を使用して、Uri クラスの新しいインスタンスを初期化します。

Uri(String, UriKind) Uri(String, UriKind) Uri(String, UriKind)

指定した URI を使用して、Uri クラスの新しいインスタンスを初期化します。 このコンストラクターでは、URI 文字列を相対 URI、絶対 URI、または不確定のいずれかに指定できます。

Uri(Uri, String) Uri(Uri, String) Uri(Uri, String) Uri(Uri, String)

指定したベース URI と相対 URI 文字列に基づいて、Uri クラスの新しいインスタンスを初期化します。

Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri)

指定したベース Uri のインスタンスと相対 Uri のインスタンスの組み合わせに基づいて、Uri クラスの新しいインスタンスを初期化します。

Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean)

明示的な文字エスケープ制御を使用し、指定したベース URI と相対 URI に基づいて、Uri クラスの新しいインスタンスを初期化します。

Uri(String) Uri(String) Uri(String) Uri(String)

指定した URI を使用して、Uri クラスの新しいインスタンスを初期化します。

public:
 Uri(System::String ^ uriString);
public Uri (string uriString);
new Uri : string -> Uri
Public Sub New (uriString As String)

パラメーター

uriString
String String String String

Uri インスタンスで表されるリソースを表す文字列。 文字列形式の IPv6 アドレスは、かっこで囲む必要があることに注意してください。 たとえば、"http://[2607:f8b0:400d:c06::69]" のようにします。

例外

Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である FormatException を代わりにキャッチします。

uriString が空です。

または uriString に指定されたスキームの形式が正しくありません。 以下を参照してください。CheckSchemeName(String)

または uriString に含まれるスラッシュが多すぎます。

または uriString に指定されたパスワードは正しくありません。

または uriString に指定されたホスト名は正しくありません。

または uriString に指定されたファイル名正しくありません。

または uriString に指定されたユーザー名は正しくありません。

または uriString に指定するホスト名または機関名が円記号で終わっていてはなりません。

または uriString に指定されたポート番号が正しくないか、解析できません。

または uriString の長さが 65519 文字を超えています。

または uriString に指定されたスキームの長さが 1023 文字を超えています。

または 正しくない文字シーケンスが uriString に含まれています。

または uriString に指定する MS-DOS のパスは、c:\\ で始める必要があります。

次の例では、作成、 Uri URI を持つインスタンス"http://www.contoso.com/"。

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );
Uri myUri = new Uri("http://www.contoso.com/");

Dim myUri As New Uri("http://www.contoso.com/")

注釈

このコンス トラクターを作成、 Uri URI 文字列からのインスタンス。 正規の形式で配置、および、必要なエスケープ エンコーディングは、URI を解析します。

このコンス トラクターとは限りませんが、Uriアクセス可能なリソースを参照します。

このコンス トラクターを前提としていますが、stringパラメーターは、絶対 URI を参照し、呼び出しと同じですが、Uriを持つコンス トラクターUriKindに設定Absoluteします。 場合、stringコンス トラクターに渡されるパラメーターは相対 URI をこのコンス トラクターがスローされます、UriFormatExceptionします。

Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext)

SerializationInfo クラスと StreamingContext クラスの指定したインスタンスから、Uri クラスの新しいインスタンスを初期化します。

protected:
 Uri(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);
protected Uri (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

パラメーター

serializationInfo
SerializationInfo SerializationInfo SerializationInfo SerializationInfo

新しい SerializationInfo インスタンスをシリアル化するために必要な情報を格納する Uri クラスのインスタンス。

streamingContext
StreamingContext StreamingContext StreamingContext StreamingContext

新しい StreamingContext インスタンスに関連付けられているシリアル化ストリームのソースを格納する Uri クラスのインスタンス。

例外

serializationInfo パラメーターには、null URI が格納されます。

serializationInfo パラメーターには空の URI が格納されます。

または 指定されたスキームの形式が正しくありません。 以下を参照してください。CheckSchemeName(String)

または URI に含まれているスラッシュが多すぎます。

または URI で指定されたパスワードが無効です。

または URI に指定されたホスト名が無効です。

または URI に指定されたファイル名が無効です。

または URI で指定されたユーザー名が無効です。

または URI に指定するホスト名または権限名の末尾には、円記号を使用できません。

または URI に指定されたポート番号が無効か、解析できません。

または URI の長さが 65519 文字を超えています。

または URI に指定されたスキームの長さが 1023 文字を超えています。

または URI に無効な文字シーケンスが含まれています。

または URI に指定する MS-DOS パスは、c:\\ で始める必要があります。

注釈

このコンス トラクターを実装して、ISerializableのためのインターフェイス、Uriクラス。

こちらもご覧ください

Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean)

警告

この API は現在使われていません。

指定した URI を使用し、明示的な文字エスケープ制御を使用して、Uri クラスの新しいインスタンスを初期化します。

public:
 Uri(System::String ^ uriString, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (string uriString, bool dontEscape);
new Uri : string * bool -> Uri
Public Sub New (uriString As String, dontEscape As Boolean)

パラメーター

uriString
String String String String

Uri インスタンスで表されるリソースを表す文字列。 文字列形式の IPv6 アドレスは、かっこで囲む必要があることに注意してください。 たとえば、"http://[2607:f8b0:400d:c06::69]" のようにします。

dontEscape
Boolean Boolean Boolean Boolean

uriString が完全にエスケープされている場合は true。それ以外の場合は false

例外

uriString が空か、空白だけを含んでいます。

または uriString に指定されたスキームが無効です。

または uriString に含まれるスラッシュが多すぎます。

または uriString に指定されたパスワードは正しくありません。

または uriString に指定されたホスト名は正しくありません。

または uriString に指定されたファイル名正しくありません。

または uriString に指定されたユーザー名は正しくありません。

または uriString に指定するホスト名または機関名が円記号で終わっていてはなりません。

または uriString に指定されたポート番号が正しくないか、解析できません。

または uriString の長さが 65519 文字を超えています。

または uriString に指定されたスキームの長さが 1023 文字を超えています。

または 正しくない文字シーケンスが uriString に含まれています。

または uriString に指定する MS-DOS のパスは、c:\\ で始める必要があります。

次の例では、作成、 Uri uri インスタンスhttp://www.contoso.com/Hello%20World.htmします。 格納されている URI が完全にエスケープされ、正規の形式では、ため、dontEscapeパラメーターを設定するtrueします。

Uri^ myUri = gcnew Uri(  "http://www.contoso.com/Hello%20World.htm",true );
Uri myUri = new Uri("http://www.contoso.com/Hello%20World.htm", true);

Dim myUri As New Uri("http://www.contoso.com/Hello%20World.htm", True)

注釈

このコンス トラクターを作成、 Uri URI 文字列からのインスタンス。 URI を解析し、正規の形式で配置されます。

dontEscapeパラメーター コントロール予約文字が変換されたかどうかにエスケープ シーケンスです。 このパラメーターに設定する必要がありますtrueURI 内のすべての予約文字をエスケープされていることを確認する場合のみです。 値を設定するtrueを完全にエスケープされていない URI 予期しない動作が発生することができます。 常にこのパラメーターを設定することを強くお勧めfalseします。

場合dontEscapeに設定されているfalse、コンス トラクターは、パーセント (%) のすべての出現箇所は有効なエスケープ シーケンスを続くことを確認して予約済みの文字をエスケープします。 次のパーセント文字シーケンスが有効でない場合は、割合が 25% に置換されます。

このコンス トラクターとは限りませんが、Uriアクセス可能なリソースを参照します。

Uri(String, UriKind) Uri(String, UriKind) Uri(String, UriKind)

指定した URI を使用して、Uri クラスの新しいインスタンスを初期化します。 このコンストラクターでは、URI 文字列を相対 URI、絶対 URI、または不確定のいずれかに指定できます。

public:
 Uri(System::String ^ uriString, UriKind uriKind);
public Uri (string uriString, UriKind uriKind);
new Uri : string * UriKind -> Uri

パラメーター

uriString
String String String String

Uri インスタンスで表されるリソースを表す文字列。 文字列形式の IPv6 アドレスは、かっこで囲む必要があることに注意してください。 たとえば、"http://[2607:f8b0:400d:c06::69]" のようにします。

uriKind
UriKind UriKind UriKind UriKind

URI 文字列が相対 URI、絶対 URI、または不確定のいずれであるかを指定します。

例外

Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である FormatException を代わりにキャッチします。

uriString は相対 URI を格納し、uriKindAbsolute です。

または uriString は絶対 URI を格納し、uriKindRelative です。

または uriString が空です。

または uriString に指定されたスキームの形式が正しくありません。 以下を参照してください。CheckSchemeName(String)

または uriString に含まれるスラッシュが多すぎます。

または uriString に指定されたパスワードは正しくありません。

または uriString に指定されたホスト名は正しくありません。

または uriString に指定されたファイル名正しくありません。

または uriString に指定されたユーザー名は正しくありません。

または uriString に指定するホスト名または機関名が円記号で終わっていてはなりません。

または uriString に指定されたポート番号が正しくないか、解析できません。

または uriString の長さが 65519 文字を超えています。

または uriString に指定されたスキームの長さが 1023 文字を超えています。

または 正しくない文字シーケンスが uriString に含まれています。

または uriString に指定する MS-DOS のパスは、c:\\ で始める必要があります。

注釈

相対と絶対 Uri では、その形式に異なる制限があります。 たとえば、相対 URI は、スキームまたは機関には必要ありません。 指定した値uriKindに渡された URI の種類に一致する必要がありますuriStringします。 ただし場合、RelativeOrAbsoluteを指定すると、相対パスまたは絶対 URI 文字列を指定します。

Uri(Uri, String) Uri(Uri, String) Uri(Uri, String) Uri(Uri, String)

指定したベース URI と相対 URI 文字列に基づいて、Uri クラスの新しいインスタンスを初期化します。

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri);
public Uri (Uri baseUri, string relativeUri);
new Uri : Uri * string -> Uri
Public Sub New (baseUri As Uri, relativeUri As String)

パラメーター

baseUri
Uri Uri Uri Uri

ベース URI。

relativeUri
String String String String

ベース URI に追加する相対 URI。

例外

Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である FormatException を代わりにキャッチします。

baseUrirelativeUri を結合して形成された URI が空であるか、スペースのみを含んでいます。

または baseUrirelativeUri を結合して形成された URI で指定されたスキームが無効です。

または baseUrirelativeUri を結合して形成された URI に含まれるスラッシュが多すぎます。

または baseUrirelativeUri を結合して形成された URI で指定されたパスワードが無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたホスト名が無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたファイル名が無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたユーザー名が無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたホスト名または機関名が円記号で終わっていてはなりません。

または baseUrirelativeUri を結合して形成された URI で指定されたポート番号が正しくないか、解析できません。

または baseUrirelativeUri を結合して形成される URI の長さが 65519 文字を超えています。

または baseUrirelativeUri を結合して形成される URI で指定されたスキームの長さが 1023 文字を超えています。

または baseUrirelativeUri を結合して形成された URI に使用できない文字シーケンスがあります。

または uriString に指定する MS-DOS のパスは、c:\\ で始める必要があります。

次の例は、の新しいインスタンスを作成、 Uri uri は相対 Uri を組み合わせることでクラスhttp://www.contoso.comおよび絶対 URI を形成する catalog/shownew.htmhttp://www.contoso.com/catalog/shownew.htmします。

Uri^ baseUri = gcnew Uri(  "http://www.contoso.com" );
Uri^ myUri = gcnew Uri( baseUri, "catalog/shownew.htm" );
Console::WriteLine( myUri->ToString() );
Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "catalog/shownew.htm");

Console.WriteLine(myUri.ToString());
   
Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "catalog/shownew.htm")

Console.WriteLine(myUri.ToString())

注釈

このコンス トラクターを作成、Uriインスタンスと組み合わせることで、 baseUrirelativeUriします。 場合relativeUri(スキーム、ホスト名、および必要に応じてポート番号を含む) は絶対 URI には、Uriのみを使用して、インスタンスが作成されたrelativeUriします。

場合、baseUri相対部分があります (など/api)、相対の一部は、スラッシュで終了する必要があります (など/api/) 場合は、相対部分baseUriする場合はで構築された保持Uri

さらに場合、relativeUri相対部分が置き換えられ、スラッシュで始まる、 baseUri

このコンス トラクターとは限りませんが、Uriアクセス可能なリソースを参照します。

Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri)

指定したベース Uri のインスタンスと相対 Uri のインスタンスの組み合わせに基づいて、Uri クラスの新しいインスタンスを初期化します。

public:
 Uri(Uri ^ baseUri, Uri ^ relativeUri);
public Uri (Uri baseUri, Uri relativeUri);
new Uri : Uri * Uri -> Uri
Public Sub New (baseUri As Uri, relativeUri As Uri)

パラメーター

baseUri
Uri Uri Uri Uri

新しい Uri インスタンスのベースとなる絶対 Uri

relativeUri
Uri Uri Uri Uri

Uri と組み合わせる相対 baseUri インスタンス。

例外

baseUri は絶対 Uri インスタンスではありません。

Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である FormatException を代わりにキャッチします。

baseUrirelativeUri を結合して形成された URI が空であるか、スペースのみを含んでいます。

または baseUrirelativeUri を結合して形成された URI で指定されたスキームが無効です。

または baseUrirelativeUri を結合して形成された URI に含まれるスラッシュが多すぎます。

または baseUrirelativeUri を結合して形成された URI で指定されたパスワードが無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたホスト名が無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたファイル名が無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたユーザー名が無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたホスト名または機関名が円記号で終わっていてはなりません。

または baseUrirelativeUri を結合して形成された URI で指定されたポート番号が正しくないか、解析できません。

または baseUrirelativeUri を結合して形成される URI の長さが 65519 文字を超えています。

または baseUrirelativeUri を結合して形成される URI で指定されたスキームの長さが 1023 文字を超えています。

または baseUrirelativeUri を結合して形成された URI に使用できない文字シーケンスがあります。

または uriString に指定する MS-DOS のパスは、c:\\ で始める必要があります。

この例は、絶対Uriインスタンス、absoluteUriと相対Uriインスタンス、relativeUriします。 新しいUriインスタンス、 combinedUri、これら 2 つのインスタンスが作成されます。

// Create an absolute Uri from a string.
String^ addressString1 = "http://www.contoso.com/";
String^ addressString2 = "catalog/shownew.htm?date=today";
Uri^ absoluteUri = gcnew Uri(addressString1);

// Create a relative Uri from a string.  allowRelative = true to allow for 
// creating a relative Uri.
Uri^ relativeUri = gcnew Uri(addressString2);

// Check whether the new Uri is absolute or relative.
if (  !relativeUri->IsAbsoluteUri )
   Console::WriteLine( "{0} is a relative Uri.", relativeUri );

// Create a new Uri from an absolute Uri and a relative Uri.
Uri^ combinedUri = gcnew Uri( absoluteUri,relativeUri );
Console::WriteLine( combinedUri->AbsoluteUri );
// Create an absolute Uri from a string.
Uri absoluteUri = new Uri("http://www.contoso.com/");

// Create a relative Uri from a string.  allowRelative = true to allow for 
// creating a relative Uri.
Uri relativeUri = new Uri("/catalog/shownew.htm?date=today", UriKind.Relative);

// Check whether the new Uri is absolute or relative.
if (!relativeUri.IsAbsoluteUri)
    Console.WriteLine("{0} is a relative Uri.", relativeUri);

// Create a new Uri from an absolute Uri and a relative Uri.
Uri combinedUri = new Uri(absoluteUri, relativeUri);
Console.WriteLine(combinedUri.AbsoluteUri);
    ' Create an absolute Uri from a string.
    Dim absoluteUri As New Uri("http://www.contoso.com/")
    
    ' Create a relative Uri from a string.  allowRelative = true to allow for 
    ' creating a relative Uri.
    Dim relativeUri As New Uri("/catalog/shownew.htm?date=today")
    
    ' Check whether the new Uri is absolute or relative.
    If Not relativeUri.IsAbsoluteUri Then
        Console.WriteLine("{0} is a relative Uri.", relativeUri)
    End If 
    ' Create a new Uri from an absolute Uri and a relative Uri.
    Dim combinedUri As New Uri(absoluteUri, relativeUri)
    Console.WriteLine(combinedUri.AbsoluteUri)

End Sub 'SampleConstructor

注釈

このコンス トラクターが新たに作成Uri絶対パスを組み合わせることによってインスタンスUriインスタンス、 baseUri、相対パスでUriインスタンス、relativeUriします。 場合relativeUriは絶対Uri(スキーム、ホスト名、および必要に応じてポート番号を含む)、インスタンス、Uriのみを使用して、インスタンスが作成されたrelativeUriします。

場合、baseUri相対部分があります (など/api)、相対の一部は、スラッシュで終了する必要があります (など/api/) 場合は、相対部分baseUriする場合はで構築された保持Uri

さらに場合、relativeUri相対部分が置き換えられ、スラッシュで始まる、 baseUri

このコンス トラクターとは限りませんが、Uriアクセス可能なリソースを参照します。

Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean)

警告

この API は現在使われていません。

明示的な文字エスケープ制御を使用し、指定したベース URI と相対 URI に基づいて、Uri クラスの新しいインスタンスを初期化します。

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (Uri baseUri, string relativeUri, bool dontEscape);
new Uri : Uri * string * bool -> Uri
Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

パラメーター

baseUri
Uri Uri Uri Uri

ベース URI。

relativeUri
String String String String

ベース URI に追加する相対 URI。

dontEscape
Boolean Boolean Boolean Boolean

uriString が完全にエスケープされている場合は true。それ以外の場合は false

例外

baseUrirelativeUri を結合して形成された URI が空であるか、スペースのみを含んでいます。

または baseUrirelativeUri を結合して形成された URI で指定されたスキームが無効です。

または baseUrirelativeUri を結合して形成された URI に含まれるスラッシュが多すぎます。

または baseUrirelativeUri を結合して形成された URI で指定されたパスワードが無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたホスト名が無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたファイル名が無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたユーザー名が無効です。

または baseUrirelativeUri を結合して形成された URI で指定されたホスト名または機関名が円記号で終わっていてはなりません。

または baseUrirelativeUri を結合して形成された URI で指定されたポート番号が正しくないか、解析できません。

または baseUrirelativeUri を結合して形成される URI の長さが 65519 文字を超えています。

または baseUrirelativeUri を結合して形成される URI で指定されたスキームの長さが 1023 文字を超えています。

または baseUrirelativeUri を結合して形成された URI に使用できない文字シーケンスがあります。

または uriString に指定する MS-DOS のパスは、c:\\ で始める必要があります。

次の例は、の新しいインスタンスを作成、 Uri uri は相対 Uri を組み合わせることでクラスhttp://www.contoso.comHello%20World.htm 絶対 URI を形成するとします。

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );
Uri^ myUri = gcnew Uri( baseUri,"Hello%20World.htm",false );
Uri baseUri = new Uri("http://www.contoso.com");
Uri myUri = new Uri(baseUri, "Hello%20World.htm",false);

Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "Hello%20World.htm", False)

注釈

このコンス トラクターを作成、Uriインスタンスと組み合わせることでbaseUrirelativeUriします。 渡された URI の場合relativeUri(スキーム、ホスト名、および必要に応じてポート番号を含む) は絶対 URI には、Uriのみを使用して、インスタンスが作成されたrelativeUri

dontEscapeパラメーター コントロール予約文字が変換されたかどうかにエスケープ シーケンスです。 このパラメーターに設定する必要がありますtrueURI 内のすべての予約文字をエスケープされていることを確認する場合のみです。 値を設定するtrueを完全にエスケープされていない URI 予期しない動作が発生することができます。 常にこのパラメーターを設定することを強くお勧めfalseします。 場合dontEscapeに設定されているfalse、コンス トラクターは、パーセント (%) のすべての出現箇所は有効なエスケープ シーケンスを続くことを確認して予約済みの文字をエスケープします。 次のパーセント文字シーケンスが有効でない場合は、割合が 25% に置換されます。

このコンス トラクターとは限りませんが、Uriアクセス可能なリソースを参照します。

注意 (呼び出し元)

セキュリティ上の問題により、アプリケーション呼び出さないでください。 このコンス トラクターの URI 文字列と信頼されていないソースからdontEscape設定trueします。 代わりに、呼び出すことによって、URI 文字列の有効性を確認できます、IsWellFormedOriginalString()このコンス トラクターを呼び出す前にメソッド。

適用対象