UriBuilder コンストラクター

定義

UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class.

オーバーロード

UriBuilder()

UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class.

UriBuilder(String)

指定した URI を使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified URI.

UriBuilder(Uri)

指定された UriBuilder インスタンスを使用して、Uri クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified Uri instance.

UriBuilder(String, String)

指定したスキームとホストを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme and host.

UriBuilder(String, String, Int32)

指定したスキーム、ホスト、およびポートを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, and port.

UriBuilder(String, String, Int32, String)

指定したスキーム、ホスト、ポート番号、およびパスを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, and path.

UriBuilder(String, String, Int32, String, String)

指定したスキーム、ホスト、ポート番号、パス、およびクエリ文字列またはフラグメント識別子を使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, path and query string or fragment identifier.

UriBuilder()

UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class.

public:
 UriBuilder();
public UriBuilder ();
Public Sub New ()

注釈

パラメーターなしのコンストラクターは、次のように初期化されたプロパティを使用して、UriBuilder クラスの新しいインスタンスを作成します。The parameterless constructor creates a new instance of the UriBuilder class with its properties initialized as follows.

プロパティProperty 初期値Initial Value
FragmentFragment Empty
HostHost バック"loopback"
PasswordPassword Empty
PathPath "/""/"
PortPort -1-1
[クエリ]Query Empty
SchemeScheme http"http"
UserNameUserName Empty

UriBuilder(String)

指定した URI を使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified URI.

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

パラメーター

uri
String

URI 文字列。A URI string.

例外

urinull です。uri is null.

Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である FormatException を代わりにキャッチします。In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

uri は長さ 0 の文字列、または空白だけを含みます。 uri is a zero-length string or contains only spaces. または-or- 解析ルーチンが無効な形式のスキームを検出しました。The parsing routine detected a scheme in an invalid form. または-or- パーサーが、"file" スキームを使用しない URI で 3 つ以上の連続するスラッシュを検出しました。The parser detected more than two consecutive slashes in a URI that does not use the "file" scheme. または-or- uri は有効な URI ではありません。uri is not a valid URI.

注釈

このコンストラクターは、Portで指定された FragmentHostPathQuerySchemeUri、および uriの各プロパティを設定して、UriBuilder クラスの新しいインスタンスを初期化します。This constructor initializes a new instance of the UriBuilder class with the Fragment, Host, Path, Port, Query, Scheme, and Uri properties set as specified in uri.

uri でスキームが指定されていない場合、スキームの既定値は "http:" になります。If uri does not specify a scheme, the scheme defaults to "http:".

UriBuilder(Uri)

指定された UriBuilder インスタンスを使用して、Uri クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified Uri instance.

public:
 UriBuilder(Uri ^ uri);
public UriBuilder (Uri uri);
new UriBuilder : Uri -> UriBuilder

パラメーター

uri
Uri

Uri クラスのインスタンス。An instance of the Uri class.

例外

urinull です。uri is null.

注釈

このコンストラクターは、Portで指定された FragmentHostPathQuerySchemeUri、および uriの各プロパティを設定して、UriBuilder クラスの新しいインスタンスを初期化します。This constructor initializes a new instance of the UriBuilder class with the Fragment, Host, Path, Port, Query, Scheme, and Uri properties set as specified in uri.

UriBuilder(String, String)

指定したスキームとホストを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme and host.

public:
 UriBuilder(System::String ^ schemeName, System::String ^ hostName);
public UriBuilder (string schemeName, string hostName);
new UriBuilder : string * string -> UriBuilder
Public Sub New (schemeName As String, hostName As String)

パラメーター

schemeName
String

インターネット アクセス プロトコル。An Internet access protocol.

hostName
String

DNS スタイルのドメイン名、または IP アドレス。A DNS-style domain name or IP address.

次の例では、URI http://www.contoso.com/を含む UriBuilder インスタンスを作成します。The following example creates a UriBuilder instance that contains the URI http://www.contoso.com/.

UriBuilder^ myUri = gcnew UriBuilder(  "http", "www.contoso.com" );
UriBuilder myUri = new UriBuilder("http","www.contoso.com");

Dim myUri As New UriBuilder("http", "www.contoso.com")

注釈

UriBuilder インスタンスは、Scheme プロパティが schemeName に設定され、Host プロパティが hostNameに設定されて初期化されます。The UriBuilder instance is initialized with the Scheme property set to schemeName and the Host property set to hostName. Port は、スキームの既定のポートを使用する必要があることを示すために値-1 に初期化され、Path プロパティはスラッシュ (/) に設定されます。Port is initialized to the value -1 to indicate the default port for the scheme should be used, and the Path property is set to the slash character (/).

UriBuilder(String, String, Int32)

指定したスキーム、ホスト、およびポートを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, and port.

public:
 UriBuilder(System::String ^ scheme, System::String ^ host, int portNumber);
public UriBuilder (string scheme, string host, int portNumber);
new UriBuilder : string * string * int -> UriBuilder
Public Sub New (scheme As String, host As String, portNumber As Integer)

パラメーター

scheme
String

インターネット アクセス プロトコル。An Internet access protocol.

host
String

DNS スタイルのドメイン名、または IP アドレス。A DNS-style domain name or IP address.

portNumber
Int32

このサービスの IP ポート番号。An IP port number for the service.

例外

portNumber が -1 より小さいか、65,535 を超えています。portNumber is less than -1 or greater than 65,535.

次の例では、URI http://www.contoso.com:8080/を含む UriBuilder インスタンスを作成します。The following example creates a UriBuilder instance that contains the URI http://www.contoso.com:8080/.

UriBuilder^ myUri = gcnew UriBuilder( "http", "www.contoso.com",8080 );
UriBuilder myUri = new UriBuilder("http","www.contoso.com",8080);

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080)

注釈

UriBuilder インスタンスは、Scheme プロパティが schemeNameに設定され、Host プロパティが hostNameに設定され、Port プロパティが portNumberに設定された状態で初期化されます。The UriBuilder instance is initialized with the Scheme property set to schemeName, the Host property set to hostName, and the Port property set to portNumber. Path プロパティはスラッシュ (/) に設定されます。The Path property is set to the slash character (/).

portNumber の値が-1 に設定されている場合は、scheme の既定のポート値が hostに接続するために使用されることを示します。If the portNumber is set to a value of -1, this indicates that the default port value for the scheme will be used to connect to the host.

UriBuilder(String, String, Int32, String)

指定したスキーム、ホスト、ポート番号、およびパスを使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, and path.

public:
 UriBuilder(System::String ^ scheme, System::String ^ host, int port, System::String ^ pathValue);
public UriBuilder (string scheme, string host, int port, string pathValue);
new UriBuilder : string * string * int * string -> UriBuilder
Public Sub New (scheme As String, host As String, port As Integer, pathValue As String)

パラメーター

scheme
String

インターネット アクセス プロトコル。An Internet access protocol.

host
String

DNS スタイルのドメイン名、または IP アドレス。A DNS-style domain name or IP address.

port
Int32

このサービスの IP ポート番号。An IP port number for the service.

pathValue
String

インターネット リソースへのパス。The path to the Internet resource.

例外

port が -1 より小さいか、65,535 を超えています。port is less than -1 or greater than 65,535.

次の例では、URI http://www.contoso.com:8080/index.htmを含む UriBuilder インスタンスを作成します。The following example creates a UriBuilder instance that contains the URI http://www.contoso.com:8080/index.htm.

UriBuilder^ myUri = gcnew UriBuilder( "http","www.contoso.com",8080,"index.htm" );
UriBuilder myUri = new UriBuilder("http","www.contoso.com",8080,"index.htm");

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080, "index.htm")

注釈

UriBuilder インスタンスは、Scheme プロパティが schemeNameに設定され、Host プロパティが hostNameに設定され、Port プロパティが portNumber に設定され、Path プロパティが pathValueに設定されて初期化されます。The UriBuilder instance is initialized with the Scheme property set to schemeName, the Host property set to hostName, the Port property set to portNumber and the Path property set to pathValue.

portNumber の値が-1 に設定されている場合は、scheme の既定のポート値が hostに接続するために使用されることを示します。If the portNumber is set to a value of -1, this indicates that the default port value for the scheme will be used to connect to the host.

UriBuilder(String, String, Int32, String, String)

指定したスキーム、ホスト、ポート番号、パス、およびクエリ文字列またはフラグメント識別子を使用して、UriBuilder クラスの新しいインスタンスを初期化します。Initializes a new instance of the UriBuilder class with the specified scheme, host, port number, path and query string or fragment identifier.

public:
 UriBuilder(System::String ^ scheme, System::String ^ host, int port, System::String ^ path, System::String ^ extraValue);
public UriBuilder (string scheme, string host, int port, string path, string extraValue);
new UriBuilder : string * string * int * string * string -> UriBuilder
Public Sub New (scheme As String, host As String, port As Integer, path As String, extraValue As String)

パラメーター

scheme
String

インターネット アクセス プロトコル。An Internet access protocol.

host
String

DNS スタイルのドメイン名、または IP アドレス。A DNS-style domain name or IP address.

port
Int32

このサービスの IP ポート番号。An IP port number for the service.

path
String

インターネット リソースへのパス。The path to the Internet resource.

extraValue
String

クエリ文字列またはフラグメント識別子。A query string or fragment identifier.

例外

extraValue が、nullEmpty、シャープ記号 (#) で始まる有効なフラグメント識別子、疑問符 (?) で始まる有効なクエリ文字列のいずれでもありません。extraValue is neither null nor Empty, nor does a valid fragment identifier begin with a number sign (#), nor a valid query string begin with a question mark (?).

port が -1 より小さいか、65,535 を超えています。port is less than -1 or greater than 65,535.

次の例では、URI http://www.contoso.com:8080/index.htm#topを含む UriBuilder インスタンスを作成します。The following example creates a UriBuilder instance that contains the URI http://www.contoso.com:8080/index.htm#top.

UriBuilder^ myUri = gcnew UriBuilder( "http","www.contoso.com",8080,"index.htm","#top" );
UriBuilder myUri = new UriBuilder("http","www.contoso.com",8080,"index.htm","#top");

Dim myUri As New UriBuilder("http", "www.contoso.com", 8080, "index.htm", "#top")

注釈

UriBuilder インスタンスは、Scheme プロパティが schemeNameに設定され、Host プロパティが hostNameに、Port プロパティが portNumberに設定され、Path プロパティが pathValueに設定されて初期化されます。The UriBuilder instance is initialized with the Scheme property set to schemeName, the Host property set to hostName, the Port property set to portNumber, and the Path property is set to pathValue. extraValue がシャープ記号 (#) で始まる場合、FragmentextraValueに設定されます。If extraValue begins with a number sign (#), then Fragment is set to extraValue. extraValue が疑問符 (?) で始まる場合、QueryextraValueに設定されます。If extraValue begins with a question mark (?), then Query is set to extraValue.

portNumber の値が-1 に設定されている場合は、scheme の既定のポート値が hostに接続するために使用されることを示します。If the portNumber is set to a value of -1, this indicates that the default port value for the scheme will be used to connect to the host.

適用対象