ServiceDescriptionとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

ServiceDescription クラス

XML Web サービスの記述に必要な名前空間、要素、および属性を完全に備えた、有効な Web サービス記述言語 (WSDL: Web Services Description Language) ドキュメントファイルを作成する方法およびフォーマット方法を提供します。このクラスは継承できません。

名前空間: System.Web.Services.Description
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 ServiceDescription
    Inherits NamedItem

Visual Basic (使用法)

Dim instance As ServiceDescription

public sealed class ServiceDescription : NamedItem

C++

public ref class ServiceDescription sealed
 : public NamedItem

public final class ServiceDescription extends
 NamedItem

JScript

public final class ServiceDescription extends
 NamedItem

解説

このクラスのインスタンスは、new キーワードまたは静的な Read メソッドのいずれかを使って作成できます。このメソッドは WSDL ファイルを解析し、その値をこのクラスの適切なメンバに代入します。

WSDL は XML ベースの言語で、XML Web サービスの記述に使用します。ServiceDescription クラスは、WSDL ファイルのルート要素 definitions に対応します。WSDL の詳細については、http://www.w3.org/TR/wsdl/ の仕様を参照してください。

使用例

ServiceDescription クラスのインスタンスを作成する方法の例を次に示します。

Visual Basic

' Obtain the ServiceDescription of existing Wsdl.
Dim myDescription As ServiceDescription = ServiceDescription.Read("MyWsdl_VB.wsdl")
' Remove the Binding from the Binding Collection of ServiceDescription.
Dim myBindingCollection As BindingCollection
 = myDescription.Bindings
myBindingCollection.Remove(myBindingCollection(0))

' Form a new Binding.
Dim myBinding As New Binding()
myBinding.Name = "Service1Soap"
Dim myXmlQualifiedName As New
 XmlQualifiedName("s0:Service1Soap")
myBinding.Type = myXmlQualifiedName

Dim mySoapBinding As New
 SoapBinding()
mySoapBinding.Transport = "http://schemas.xmlsoap.org/soap/http"
mySoapBinding.Style = SoapBindingStyle.Document

Dim addOperationBinding As OperationBinding
 = CreateOperationBinding("Add", _
                                             myDescription.TargetNamespace)
myBinding.Operations.Add(addOperationBinding)
myBinding.Extensions.Add(mySoapBinding)

' Add the Binding to the ServiceDescription.
myDescription.Bindings.Add(myBinding)
myDescription.Write("MyOutWsdl.wsdl")

// Obtain the ServiceDescription of existing Wsdl.
ServiceDescription myDescription = ServiceDescription.Read("MyWsdl_CS.wsdl");
// Remove the Binding from the Binding Collection of ServiceDescription.
BindingCollection myBindingCollection = myDescription.Bindings;
myBindingCollection.Remove(myBindingCollection[0]);

// Form a new Binding.
Binding myBinding = new Binding();
myBinding.Name = "Service1Soap";
XmlQualifiedName myXmlQualifiedName = 
                     new XmlQualifiedName("s0:Service1Soap");
myBinding.Type = myXmlQualifiedName;

SoapBinding mySoapBinding = new SoapBinding();
mySoapBinding.Transport = "http://schemas.xmlsoap.org/soap/http";
mySoapBinding.Style = SoapBindingStyle.Document;

OperationBinding addOperationBinding = 
       CreateOperationBinding("Add",myDescription.TargetNamespace);
myBinding.Operations.Add(addOperationBinding);
myBinding.Extensions.Add(mySoapBinding);

// Add the Binding to the ServiceDescription.
myDescription.Bindings.Add(myBinding);
myDescription.Write("MyOutWsdl.wsdl");

C++

// Obtain the ServiceDescription of existing Wsdl.
ServiceDescription^ myDescription = ServiceDescription::Read( "MyWsdl_CS.wsdl"
 );

// Remove the Binding from the Binding Collection of ServiceDescription.
BindingCollection^ myBindingCollection = myDescription->Bindings;
myBindingCollection->Remove( myBindingCollection[ 0 ] );

// Form a new Binding.
Binding^ myBinding = gcnew Binding;
myBinding->Name = "Service1Soap";
XmlQualifiedName^ myXmlQualifiedName = gcnew XmlQualifiedName( "s0:Service1Soap"
 );
myBinding->Type = myXmlQualifiedName;
SoapBinding^ mySoapBinding = gcnew SoapBinding;
mySoapBinding->Transport = "http://schemas.xmlsoap.org/soap/http";
mySoapBinding->Style = SoapBindingStyle::Document;
OperationBinding^ addOperationBinding = CreateOperationBinding( "Add",
 myDescription->TargetNamespace );
myBinding->Operations->Add( addOperationBinding );
myBinding->Extensions->Add( mySoapBinding );

// Add the Binding to the ServiceDescription.
myDescription->Bindings->Add( myBinding );
myDescription->Write( "MyOutWsdl.wsdl" );

// Obtain the ServiceDescription of existing Wsdl.
ServiceDescription myDescription = ServiceDescription.
    Read("MyWsdl_JSL.wsdl");
// Remove the Binding from the Binding Collection of 
// ServiceDescription.
BindingCollection myBindingCollection = myDescription.
    get_Bindings();
myBindingCollection.Remove(myBindingCollection.get_Item(0));
// Form a new Binding.
Binding myBinding = new Binding();
myBinding.set_Name("Service1Soap");
XmlQualifiedName myXmlQualifiedName = new 
    XmlQualifiedName("s0:Service1Soap");
myBinding.set_Type(myXmlQualifiedName);

SoapBinding mySoapBinding = new SoapBinding();
mySoapBinding.set_Transport("http://schemas.xmlsoap.org/soap/http");
mySoapBinding.set_Style(SoapBindingStyle.Document);

OperationBinding addOperationBinding = CreateOperationBinding("Add",
    myDescription.get_TargetNamespace());
myBinding.get_Operations().Add(addOperationBinding);
myBinding.get_Extensions().Add(mySoapBinding);
// Add the Binding to the ServiceDescription.
myDescription.get_Bindings().Add(myBinding);
myDescription.Write("MyOutWsdl.wsdl");

継承階層

System.Object
   System.Web.Services.Description.DocumentableItem
     System.Web.Services.Description.NamedItem
      System.Web.Services.Description.ServiceDescription

スレッドセーフ

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

プラットフォーム

バージョン情報

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

参照

関連項目
ServiceDescription メンバ
System.Web.Services.Description 名前空間

ServiceDescription コンストラクタ

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

名前空間: System.Web.Services.Description
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New ServiceDescription

public ServiceDescription ()

C++

public:
ServiceDescription ()

public ServiceDescription ()

JScript

public function ServiceDescription ()

プラットフォーム

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

参照

ServiceDescription フィールド

パブリックフィールドパブリックフィールド

	名前	説明
	Namespace	ServiceDescription クラスが定義されている XML 名前空間 ("http://schemas.xmlsoap.org/wsdl/")。このフィールドは定数です。

参照

ServiceDescription プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	Bindings	ServiceDescription に格納されている Binding 要素のコレクションを取得します。
	Documentation	DocumentableItem のインスタンスのテキストドキュメントを取得または設定します。 ( DocumentableItem から継承されます。)
	DocumentationElement	DocumentableItem のドキュメント要素を取得または設定します。 ( DocumentableItem から継承されます。)
	ExtensibleAttributes	Web Services Interoperability (WS-I) Basic Profile 1.1 に準拠する WSDL の属性の拡張機能を表す XmlAttribute 型の配列を取得または設定します。 ( DocumentableItem から継承されます。)
	Extensions	オーバーライドされます。 ServiceDescription に格納されている機能拡張要素のコレクションを取得します。
	Imports	ServiceDescription に格納されている Import 要素のコレクションを取得します。
	Messages	ServiceDescription に格納されている Message 要素のコレクションを取得します。
	Name	項目の名前を取得または設定します。 ( NamedItem から継承されます。)
	Namespaces	ServiceDescription オブジェクトが生成されるときに名前空間プレフィックスと名前空間を保持するために使用する、名前空間プレフィックスと名前空間のディクショナリを取得または設定します。 ( DocumentableItem から継承されます。)
	ServiceDescriptions	ServiceDescription がメンバとして含まれている ServiceDescriptionCollection インスタンスを取得します。
	Services	ServiceDescription に格納されている Service インスタンスのコレクションを取得します。
	TargetNamespace	Web サービス記述言語 (WSDL :Web Services Description Language) ファイルを囲む descriptions タグの XML targetNamespace 属性を取得または設定します。
	Types	ServiceDescription に格納された Types を取得または設定します。
	ValidationWarnings	Read(Stream,Boolean)、Read(TextReader,Boolean)、Read(String,Boolean)、または Read(XmlReader,Boolean) を、true に設定した validate パラメータを指定して呼び出したときに生成された検証の警告を格納する StringCollection を取得します。

参照

ServiceDescription メソッド

パブリックメソッドパブリックメソッド

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

	名前	説明
	CanRead	XmlReader が、解析できる有効な Web サービス記述言語 (WSDL: Web Services Description Language) ファイルを表すかどうかを示す値を取得します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Read	オーバーロードされます。 XML を直接読み込んで、ServiceDescription クラスのインスタンスを初期化します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	Write	オーバーロードされます。 ServiceDescription を Web サービス記述言語 (WSDL) ファイルとして書き込みます。

プロテクトメソッド

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

参照

ServiceDescription メンバ

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

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

	名前	説明
	ServiceDescription

パブリックフィールド

	名前	説明
	Namespace	ServiceDescription クラスが定義されている XML 名前空間 ("http://schemas.xmlsoap.org/wsdl/")。このフィールドは定数です。

パブリックプロパティ

	名前	説明
	Bindings	ServiceDescription に格納されている Binding 要素のコレクションを取得します。
	Documentation	DocumentableItem のインスタンスのテキストドキュメントを取得または設定します。(DocumentableItem から継承されます。)
	DocumentationElement	DocumentableItem のドキュメント要素を取得または設定します。(DocumentableItem から継承されます。)
	ExtensibleAttributes	Web Services Interoperability (WS-I) Basic Profile 1.1 に準拠する WSDL の属性の拡張機能を表す XmlAttribute 型の配列を取得または設定します。(DocumentableItem から継承されます。)
	Extensions	オーバーライドされます。 ServiceDescription に格納されている機能拡張要素のコレクションを取得します。
	Imports	ServiceDescription に格納されている Import 要素のコレクションを取得します。
	Messages	ServiceDescription に格納されている Message 要素のコレクションを取得します。
	Name	項目の名前を取得または設定します。(NamedItem から継承されます。)
	Namespaces	ServiceDescription オブジェクトが生成されるときに名前空間プレフィックスと名前空間を保持するために使用する、名前空間プレフィックスと名前空間のディクショナリを取得または設定します。(DocumentableItem から継承されます。)
	ServiceDescriptions	ServiceDescription がメンバとして含まれている ServiceDescriptionCollection インスタンスを取得します。
	Services	ServiceDescription に格納されている Service インスタンスのコレクションを取得します。
	TargetNamespace	Web サービス記述言語 (WSDL :Web Services Description Language) ファイルを囲む descriptions タグの XML targetNamespace 属性を取得または設定します。
	Types	ServiceDescription に格納された Types を取得または設定します。
	ValidationWarnings	Read(Stream,Boolean)、Read(TextReader,Boolean)、Read(String,Boolean)、または Read(XmlReader,Boolean) を、true に設定した validate パラメータを指定して呼び出したときに生成された検証の警告を格納する StringCollection を取得します。

パブリックメソッド

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

	名前	説明
	CanRead	XmlReader が、解析できる有効な Web サービス記述言語 (WSDL: Web Services Description Language) ファイルを表すかどうかを示す値を取得します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Read	オーバーロードされます。 XML を直接読み込んで、ServiceDescription クラスのインスタンスを初期化します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	Write	オーバーロードされます。 ServiceDescription を Web サービス記述言語 (WSDL) ファイルとして書き込みます。

プロテクトメソッド

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

参照

ServiceDescriptionとは？わかりやすく解説

ServiceDescription クラス

ServiceDescription コンストラクタ

.NET Framework

関連項目

ServiceDescription フィールド

関連項目

ServiceDescription プロパティ

関連項目

ServiceDescription メソッド

関連項目

ServiceDescription メンバ

関連項目

「ServiceDescription」の関連用語


	© 2025 Microsoft.All rights reserved.

ServiceDescriptionとは？ わかりやすく解説

ServiceDescription クラス

ServiceDescription コンストラクタ

.NET Framework

関連項目

ServiceDescription フィールド

関連項目

ServiceDescription プロパティ

関連項目

ServiceDescription メソッド

関連項目

ServiceDescription メンバ

関連項目

急上昇のことば

「ServiceDescription」の関連用語

ServiceDescriptionとは？わかりやすく解説