UriBuilder

.NET Framework クラス ライブラリ リファレンス

UriBuilder クラス

URI (Uniform Resource Identifier) のカスタム コンストラクタを提供し、Uri クラスの URI を変更します。

名前空間: System
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Class UriBuilder

Visual Basic (使用法)

Dim instance As UriBuilder

C#

public class UriBuilder

C++

public ref class UriBuilder

J#

public class UriBuilder

JScript

public class UriBuilder

解説

UriBuilder クラスを使用すると、変更するたびに新しい Uri インスタンスを作成することなく、この Uri インスタンスの内容を変更できます。

UriBuilder プロパティを使用すると、読み取り/書き込みアクセスによって、Uri プロパティを変更できます。

継承階層

System.Object
  System.UriBuilder

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
UriBuilder メンバ
System 名前空間
Uri クラス

UriBuilder コンストラクタ ()

UriBuilder クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New UriBuilder

C#

public UriBuilder ()

C++

public:
UriBuilder ()

J#

public UriBuilder ()

JScript

public function UriBuilder ()

解説

既定のコンストラクタは、次のようにプロパティを初期化して、UriBuilder クラスの新しいインスタンスを作成します。

プロパティ	初期値
Fragment	Empty
Host	"loopback"
Password	Empty
Path	"/"
Port	-1
Query	Empty
Scheme	"http"
UserName	Empty

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
UriBuilder クラス
UriBuilder メンバ
System 名前空間

UriBuilder コンストラクタ (String, String, Int32, String, String)

指定したスキーム、ホスト、ポート番号、パス、およびクエリ文字列またはフラグメント識別子を使用して、UriBuilder クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    scheme As String, _
    host As String, _
    port As Integer, _
    path As String, _
    extraValue As String _
)

Visual Basic (使用法)

Dim scheme As String
Dim host As String
Dim port As Integer
Dim path As String
Dim extraValue As String

Dim instance As New UriBuilder(scheme,
 host, port, path, extraValue)

C#

public UriBuilder (
    string scheme,
    string host,
    int port,
    string path,
    string extraValue
)

C++

public:
UriBuilder (
    String^ scheme, 
    String^ host, 
    int port, 
    String^ path, 
    String^ extraValue
)

J#

public UriBuilder (
    String scheme, 
    String host, 
    int port, 
    String path, 
    String extraValue
)

JScript

public function UriBuilder (
    scheme : String, 
    host : String, 
    port : int, 
    path : String, 
    extraValue : String
)

パラメータ

scheme

インターネット アクセス プロトコル。

host

DNS スタイルのドメイン名、または IP アドレス。

port

このサービスの IP ポート番号。

path

インターネット リソースへのパス。

extraValue

クエリ文字列またはフラグメント識別子。

例外

例外の種類	条件
ArgumentException	extraValue が、null 参照 (Visual Basic では Nothing)、Empty、シャープ記号 (#) で始まる有効なフラグメント識別子、疑問符 (?) で始まる有効なクエリ文字列のいずれでもありません。
ArgumentOutOfRangeException	port が 0 未満です。

解説

UriBuilder インスタンスは、Scheme プロパティを schemeName に、Host プロパティを hostName に、Port プロパティを portNumber に、および Path プロパティを pathValue にそれぞれ設定して、初期化されます。extraValue がシャープ記号 (#) で始まる場合には、Fragment が extraValue に設定されます。extraValue が疑問符 (?) で始まる場合には、Query が extraValue に設定されます。

使用例

http://www.contoso.com:8080/index.htm#top という URI を含む UriBuilder インスタンスを作成する例を次に示します。

Visual Basic

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

C#

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

C++

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

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
UriBuilder クラス
UriBuilder メンバ
System 名前空間

UriBuilder コンストラクタ (Uri)

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

名前空間: System
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    uri As Uri _
)

Visual Basic (使用法)

Dim uri As Uri

Dim instance As New UriBuilder(uri)

C#

public UriBuilder (
    Uri uri
)

C++

public:
UriBuilder (
    Uri^ uri
)

J#

public UriBuilder (
    Uri uri
)

JScript

public function UriBuilder (
    uri : Uri
)

パラメータ

uri

Uri クラスのインスタンス。

例外

例外の種類	条件
NullReferenceException	uri が null 参照 (Visual Basic では Nothing) です。

解説

このコンストラクタは、uri に指定した Fragment、Host、Path、Port、Query、Scheme および Uri の各プロパティ設定を使用して、UriBuilder クラスの新しいインスタンスを初期化します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
UriBuilder クラス
UriBuilder メンバ
System 名前空間

UriBuilder コンストラクタ (String, String, Int32, String)

指定したスキーム、ホスト、ポート番号、およびパスを使用して、UriBuilder クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    scheme As String, _
    host As String, _
    port As Integer, _
    pathValue As String _
)

Visual Basic (使用法)

Dim scheme As String
Dim host As String
Dim port As Integer
Dim pathValue As String

Dim instance As New UriBuilder(scheme,
 host, port, pathValue)

C#

public UriBuilder (
    string scheme,
    string host,
    int port,
    string pathValue
)

C++

public:
UriBuilder (
    String^ scheme, 
    String^ host, 
    int port, 
    String^ pathValue
)

J#

public UriBuilder (
    String scheme, 
    String host, 
    int port, 
    String pathValue
)

JScript

public function UriBuilder (
    scheme : String, 
    host : String, 
    port : int, 
    pathValue : String
)

パラメータ

scheme

インターネット アクセス プロトコル。

host

DNS スタイルのドメイン名、または IP アドレス。

port

このサービスの IP ポート番号。

pathValue

インターネット リソースへのパス。

例外

例外の種類	条件
ArgumentOutOfRangeException	port が 0 未満です。

解説

UriBuilder インスタンスは、Scheme プロパティを schemeName に、Host プロパティを hostName に、Port プロパティを portNumber に、および Path プロパティを pathValue にそれぞれ設定して、初期化されます。

使用例

http://www.contoso.com:8080/index.htm という URI を含む UriBuilder インスタンスを作成する例を次に示します。

Visual Basic

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

C#

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

C++

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

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
UriBuilder クラス
UriBuilder メンバ
System 名前空間

UriBuilder コンストラクタ

UriBuilder クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
UriBuilder ()	UriBuilder クラスの新しいインスタンスを初期化します。
UriBuilder (String)	指定した URI を使用して、UriBuilder クラスの新しいインスタンスを初期化します。
UriBuilder (Uri)	指定した Uri インスタンスを使用して、UriBuilder クラスの新しいインスタンスを初期化します。
UriBuilder (String, String)	指定したスキームとホストを使用して、UriBuilder クラスの新しいインスタンスを初期化します。
UriBuilder (String, String, Int32)	指定したスキーム、ホスト、およびポートを使用して、UriBuilder クラスの新しいインスタンスを初期化します。
UriBuilder (String, String, Int32, String)	指定したスキーム、ホスト、ポート番号、およびパスを使用して、UriBuilder クラスの新しいインスタンスを初期化します。
UriBuilder (String, String, Int32, String, String)	指定したスキーム、ホスト、ポート番号、パス、およびクエリ文字列またはフラグメント識別子を使用して、UriBuilder クラスの新しいインスタンスを初期化します。

参照

関連項目

UriBuilder クラス
UriBuilder メンバ
System 名前空間

UriBuilder コンストラクタ (String, String)

指定したスキームとホストを使用して、UriBuilder クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    schemeName As String, _
    hostName As String _
)

Visual Basic (使用法)

Dim schemeName As String
Dim hostName As String

Dim instance As New UriBuilder(schemeName,
 hostName)

C#

public UriBuilder (
    string schemeName,
    string hostName
)

C++

public:
UriBuilder (
    String^ schemeName, 
    String^ hostName
)

J#

public UriBuilder (
    String schemeName, 
    String hostName
)

JScript

public function UriBuilder (
    schemeName : String, 
    hostName : String
)

パラメータ

schemeName

インターネット アクセス プロトコル。

hostName

DNS スタイルのドメイン名、または IP アドレス。

解説

UriBuilder インスタンスは、Scheme プロパティを schemeName に、Host プロパティを hostName に設定して初期化されます。Port は、値 -1 に設定して初期化されます。この値は、スキームの既定ポートが使用され、Path プロパティがスラッシュ文字 (/) に設定されることを示します。

使用例

http://www.contoso.com/ という URI を含む UriBuilder インスタンスを作成する例を次に示します。

Visual Basic

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

C#

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

C++

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

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
UriBuilder クラス
UriBuilder メンバ
System 名前空間

UriBuilder コンストラクタ (String)

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

名前空間: System
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    uri As String _
)

Visual Basic (使用法)

Dim uri As String

Dim instance As New UriBuilder(uri)

C#

public UriBuilder (
    string uri
)

C++

public:
UriBuilder (
    String^ uri
)

J#

public UriBuilder (
    String uri
)

JScript

public function UriBuilder (
    uri : String
)

パラメータ

uri

URI 文字列。

例外

例外の種類	条件
ArgumentNullException	uri が null 参照 (Visual Basic では Nothing) です。
UriFormatException	uri の長さが 0 か、空白しか含まれていません。 または 解析ルーチンが無効な形式のスキームを検出しました。 または パーサーが、"file" スキームを使用しない URI で 3 つ以上の連続するスラッシュを検出しました。 または uri が有効な URI ではありません。

解説

このコンストラクタは、uri に指定した Fragment、Host、Path、Port、Query、Scheme および Uri の各プロパティ設定を使用して、UriBuilder クラスの新しいインスタンスを初期化します。

uri でスキームが指定されない場合は、既定のスキーム "http:" が使用されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
UriBuilder クラス
UriBuilder メンバ
System 名前空間

UriBuilder コンストラクタ (String, String, Int32)

指定したスキーム、ホスト、およびポートを使用して、UriBuilder クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    scheme As String, _
    host As String, _
    portNumber As Integer _
)

Visual Basic (使用法)

Dim scheme As String
Dim host As String
Dim portNumber As Integer

Dim instance As New UriBuilder(scheme,
 host, portNumber)

C#

public UriBuilder (
    string scheme,
    string host,
    int portNumber
)

C++

public:
UriBuilder (
    String^ scheme, 
    String^ host, 
    int portNumber
)

J#

public UriBuilder (
    String scheme, 
    String host, 
    int portNumber
)

JScript

public function UriBuilder (
    scheme : String, 
    host : String, 
    portNumber : int
)

パラメータ

scheme

インターネット アクセス プロトコル。

host

DNS スタイルのドメイン名、または IP アドレス。

portNumber

このサービスの IP ポート番号。

例外

例外の種類	条件
ArgumentOutOfRangeException	portNumber が 0 未満です。

解説

Scheme プロパティを schemeName に設定し、Host プロパティを hostName に設定し、Port プロパティを portNumber に設定して、UriBuilder インスタンスを初期化します。Path プロパティには、スラッシュ文字 (/) が設定されます。

使用例

http://www.contoso.com:8080/ という URI を含む UriBuilder インスタンスを作成する例を次に示します。

Visual Basic

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

C#

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

C++

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

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
UriBuilder クラス
UriBuilder メンバ
System 名前空間

UriBuilder プロパティ

パブリック プロパティ

	名前	説明
	Fragment	URI のフラグメント部分を取得または設定します。
	Host	サーバーの DNS (Domain Name System) ホスト名または IP アドレスを取得または設定します。
	Password	URI へアクセスするユーザーに関連付けられているパスワードを取得または設定します。
	Path	URI によって参照されるリソースのパスを取得または設定します。
	Port	URI のポート番号を取得または設定します。
	Query	URI に含まれているクエリ情報を取得または設定します。
	Scheme	URI のスキーム名を取得または設定します。
	Uri	指定した UriBuilder により作成された Uri インスタンスを取得します。
	UserName	URI へアクセスするユーザーに関連付けられているユーザー名。

参照

関連項目

UriBuilder クラス
System 名前空間
Uri クラス

UriBuilder メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 オーバーライドされます。
	GetHashCode	オーバーライドされます。 URI のハッシュ コードを返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	オーバーライドされます。 指定した UriBuilder インスタンスの表示文字列を返します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

UriBuilder クラス
System 名前空間
Uri クラス

UriBuilder メンバ

URI (Uniform Resource Identifier) のカスタム コンストラクタを提供し、Uri クラスの URI を変更します。

UriBuilder データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	UriBuilder	オーバーロードされます。 UriBuilder クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Fragment	URI のフラグメント部分を取得または設定します。
	Host	サーバーの DNS (Domain Name System) ホスト名または IP アドレスを取得または設定します。
	Password	URI へアクセスするユーザーに関連付けられているパスワードを取得または設定します。
	Path	URI によって参照されるリソースのパスを取得または設定します。
	Port	URI のポート番号を取得または設定します。
	Query	URI に含まれているクエリ情報を取得または設定します。
	Scheme	URI のスキーム名を取得または設定します。
	Uri	指定した UriBuilder により作成された Uri インスタンスを取得します。
	UserName	URI へアクセスするユーザーに関連付けられているユーザー名。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 オーバーライドされます。
	GetHashCode	オーバーライドされます。 URI のハッシュ コードを返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	オーバーライドされます。 指定した UriBuilder インスタンスの表示文字列を返します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

UriBuilder クラス
System 名前空間
Uri クラス