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

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

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

SoapHeaderBinding クラス

XML Web サービス内の InputBinding または OutputBinding に追加される拡張要素を表します。

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

Visual Basic (宣言)

Public Class SoapHeaderBinding
    Inherits ServiceDescriptionFormatExtension

Visual Basic (使用法)

Dim instance As SoapHeaderBinding

public class SoapHeaderBinding : ServiceDescriptionFormatExtension

C++

public ref class SoapHeaderBinding : public
 ServiceDescriptionFormatExtension

public class SoapHeaderBinding extends ServiceDescriptionFormatExtension

JScript

public class SoapHeaderBinding extends
 ServiceDescriptionFormatExtension

解説

XML Web サービスのプロトコルの指定の詳細については、「ASP.NET を使用した XML Web サービス」を参照してください。WSDL (Web Services Description Language) の詳細については、http://www.w3.org/TR/wsdl/ の仕様を参照してください。

使用例

Visual Basic

Imports System
Imports System.Web.Services.Description
Imports System.Collections
Imports System.Xml

Public Class MySampleClass
   Public Shared Sub Main()
      Dim myServiceDescription As ServiceDescription
 = _
                        ServiceDescription.Read("SoapHeaderBindingInput_vb.wsdl")
      Dim myBinding As New
 Binding()
      myBinding.Name = "MyWebServiceSoap"
      myBinding.Type = New XmlQualifiedName("s0:MyWebServiceSoap")

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

      Dim myOperationBinding As New
 OperationBinding()
      myOperationBinding.Name = "Hello"

      Dim mySoapOperationBinding As New
 SoapOperationBinding()
      mySoapOperationBinding.SoapAction = "http://tempuri.org/Hello"
      mySoapOperationBinding.Style = SoapBindingStyle.Document
      myOperationBinding.Extensions.Add(mySoapOperationBinding)

      ' Create InputBinding for operation for the 'SOAP' protocol.
      Dim myInputBinding As New
 InputBinding()
      Dim mySoapBodyBinding As New
 SoapBodyBinding()
      mySoapBodyBinding.Use = SoapBindingUse.Literal
      myInputBinding.Extensions.Add(mySoapBodyBinding)
      Dim mySoapHeaderBinding As New
 SoapHeaderBinding()
      mySoapHeaderBinding.Message = New XmlQualifiedName("s0:HelloMyHeader")
      mySoapHeaderBinding.Part = "MyHeader"
      mySoapHeaderBinding.Use = SoapBindingUse.Literal
      ' Add mySoapHeaderBinding to 'myInputBinding' object.
      myInputBinding.Extensions.Add(mySoapHeaderBinding)
      ' Create OutputBinding for operation for the 'SOAP' protocol.
      Dim myOutputBinding As New
 OutputBinding()
      myOutputBinding.Extensions.Add(mySoapBodyBinding)

      ' Add 'InputBinding' and 'OutputBinding' to 'OperationBinding'.
      myOperationBinding.Input = myInputBinding
      myOperationBinding.Output = myOutputBinding
      myBinding.Operations.Add(myOperationBinding)

      myServiceDescription.Bindings.Add(myBinding)
      myServiceDescription.Write("SoapHeaderBindingOut_vb.wsdl")
      Console.WriteLine("'SoapHeaderBindingOut_vb.wsdl' file is
 generated.")
      Console.WriteLine("Proxy could be created using "
 + _
                        "'wsdl /language:VB SoapHeaderBindingOut_vb.wsdl'.")
   End Sub 'Main
End Class 'MySampleClass

   using System;
   using System.Web.Services.Description;
   using System.Collections;
   using System.Xml;

   public class MySampleClass
   {
   public static void Main()
   {
      ServiceDescription myServiceDescription = 
         ServiceDescription.Read("SoapHeaderBindingInput_cs.wsdl");
      Binding myBinding = new Binding();
      myBinding.Name = "MyWebServiceSoap";
      myBinding.Type =new XmlQualifiedName("s0:MyWebServiceSoap");

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

      OperationBinding myOperationBinding = new OperationBinding();
      myOperationBinding.Name = "Hello";

      SoapOperationBinding mySoapOperationBinding = 
         new SoapOperationBinding();
      mySoapOperationBinding.SoapAction = "http://tempuri.org/Hello";
      mySoapOperationBinding.Style=SoapBindingStyle.Document;
      myOperationBinding.Extensions.Add(mySoapOperationBinding);

      // Create InputBinding for operation for the 'SOAP' protocol.
      InputBinding myInputBinding = new InputBinding();
      SoapBodyBinding mySoapBodyBinding = new SoapBodyBinding();
      mySoapBodyBinding.Use = SoapBindingUse.Literal;
      myInputBinding.Extensions.Add(mySoapBodyBinding);
      SoapHeaderBinding mySoapHeaderBinding=new SoapHeaderBinding();
      mySoapHeaderBinding.Message=new XmlQualifiedName("s0:HelloMyHeader");
      mySoapHeaderBinding.Part="MyHeader";
      mySoapHeaderBinding.Use=SoapBindingUse.Literal;
      // Add mySoapHeaderBinding to 'myInputBinding' object. 
      myInputBinding.Extensions.Add(mySoapHeaderBinding);
      // Create OutputBinding for operation for the 'SOAP' protocol.
      OutputBinding myOutputBinding = new OutputBinding();
      myOutputBinding.Extensions.Add(mySoapBodyBinding);

      // Add 'InputBinding' and 'OutputBinding' to 'OperationBinding'.
 
      myOperationBinding.Input = myInputBinding;
      myOperationBinding.Output = myOutputBinding;
      myBinding.Operations.Add(myOperationBinding);

      myServiceDescription.Bindings.Add(myBinding);
      myServiceDescription.Write("SoapHeaderBindingOut_cs.wsdl");
      Console.WriteLine("'SoapHeaderBindingOut_cs.wsdl' file is generated.");
      Console.WriteLine("Proxy could be created using "
                           +"'wsdl SoapHeaderBindingOut_cs.wsdl'.");
   }
}

C++

#using <System.dll>
#using <System.Web.Services.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::Web::Services::Description;
using namespace System::Collections;
using namespace System::Xml;

int main()
{
   ServiceDescription^ myServiceDescription = ServiceDescription::Read( "SoapHeaderBindingInput_cpp.wsdl"
 );
   Binding^ myBinding = gcnew Binding;
   myBinding->Name = "MyWebServiceSoap";
   myBinding->Type = gcnew XmlQualifiedName( "s0:MyWebServiceSoap" );
   SoapBinding^ mySoapBinding = gcnew SoapBinding;
   mySoapBinding->Transport = "http://schemas.xmlsoap.org/soap/http";
   mySoapBinding->Style = SoapBindingStyle::Document;
   myBinding->Extensions->Add( mySoapBinding );
   OperationBinding^ myOperationBinding = gcnew OperationBinding;
   myOperationBinding->Name = "Hello";
   SoapOperationBinding^ mySoapOperationBinding = gcnew SoapOperationBinding;
   mySoapOperationBinding->SoapAction = "http://tempuri.org/Hello";
   mySoapOperationBinding->Style = SoapBindingStyle::Document;
   myOperationBinding->Extensions->Add( mySoapOperationBinding );

   // Create InputBinding for operation for the 'SOAP' protocol.
   InputBinding^ myInputBinding = gcnew InputBinding;
   SoapBodyBinding^ mySoapBodyBinding = gcnew SoapBodyBinding;
   mySoapBodyBinding->Use = SoapBindingUse::Literal;
   myInputBinding->Extensions->Add( mySoapBodyBinding );
   SoapHeaderBinding^ mySoapHeaderBinding = gcnew SoapHeaderBinding;
   mySoapHeaderBinding->Message = gcnew XmlQualifiedName( "s0:HelloMyHeader"
 );
   mySoapHeaderBinding->Part = "MyHeader";
   mySoapHeaderBinding->Use = SoapBindingUse::Literal;

   // Add mySoapHeaderBinding to 'myInputBinding' object.
   myInputBinding->Extensions->Add( mySoapHeaderBinding );

   // Create OutputBinding for operation for the 'SOAP' protocol.
   OutputBinding^ myOutputBinding = gcnew OutputBinding;
   myOutputBinding->Extensions->Add( mySoapBodyBinding );

   // Add 'InputBinding' and 'OutputBinding' to 'OperationBinding'.
   myOperationBinding->Input = myInputBinding;
   myOperationBinding->Output = myOutputBinding;
   myBinding->Operations->Add( myOperationBinding );
   myServiceDescription->Bindings->Add( myBinding );
   myServiceDescription->Write( "SoapHeaderBindingOut_cpp.wsdl" );
   Console::WriteLine( "'SoapHeaderBindingOut_cpp.wsdl' file is generated."
 );
   Console::WriteLine( "Proxy could be created using 'wsdl
 SoapHeaderBindingOut_cpp.wsdl'." );
}

import System.*;
import System.Web.Services.Description.*;
import System.Collections.*;
import System.Xml.*;

public class MySampleClass
{
    public static void main(String[]
 args)
    {
        ServiceDescription myServiceDescription 
            = ServiceDescription.Read("SoapHeaderBindingInput_jsl.wsdl");
        Binding myBinding = new Binding();
        myBinding.set_Name("MyWebServiceSoap");
        myBinding.set_Type(new XmlQualifiedName("s0:MyWebServiceSoap"));

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

        OperationBinding myOperationBinding = new OperationBinding();
        myOperationBinding.set_Name("Hello");

        SoapOperationBinding mySoapOperationBinding 
            = new SoapOperationBinding();
        mySoapOperationBinding.set_SoapAction("http://tempuri.org/Hello");
        mySoapOperationBinding.set_Style(SoapBindingStyle.Document);
        myOperationBinding.get_Extensions().Add(mySoapOperationBinding);
        // Create InputBinding for operation for the 'SOAP' protocol.
        InputBinding myInputBinding = new InputBinding();
        SoapBodyBinding mySoapBodyBinding = new SoapBodyBinding();
        mySoapBodyBinding.set_Use(SoapBindingUse.Literal);
        myInputBinding.get_Extensions().Add(mySoapBodyBinding);
        SoapHeaderBinding mySoapHeaderBinding = new SoapHeaderBinding();
        mySoapHeaderBinding.set_Message(new XmlQualifiedName(
            "s0:HelloMyHeader"));
        mySoapHeaderBinding.set_Part("MyHeader");
        mySoapHeaderBinding.set_Use(SoapBindingUse.Literal);
        // Add mySoapHeaderBinding to 'myInputBinding' object. 
        myInputBinding.get_Extensions().Add(mySoapHeaderBinding);
        // Create OutputBinding for operation for the 'SOAP' protocol.
        OutputBinding myOutputBinding = new OutputBinding();
        myOutputBinding.get_Extensions().Add(mySoapBodyBinding);
        // Add 'InputBinding' and 'OutputBinding' to 'OperationBinding'.
 
        myOperationBinding.set_Input(myInputBinding);
        myOperationBinding.set_Output(myOutputBinding);
        myBinding.get_Operations().Add(myOperationBinding);

        myServiceDescription.get_Bindings().Add(myBinding);
        myServiceDescription.Write("SoapHeaderBindingOut_jsl.wsdl");
        Console.WriteLine("'SoapHeaderBindingOut_jsl.wsdl' file is generated.");
        Console.WriteLine("Proxy could be created using "
 
            + "'wsdl SoapHeaderBindingOut_jsl.wsdl'.");
    } //main
} //MySampleClass

継承階層

System.Object
   System.Web.Services.Description.ServiceDescriptionFormatExtension
    System.Web.Services.Description.SoapHeaderBinding
       System.Web.Services.Description.Soap12HeaderBinding

スレッドセーフ

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

プラットフォーム

バージョン情報

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

参照

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

SoapHeaderBinding コンストラクタ

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SoapHeaderBinding

public SoapHeaderBinding ()

C++

public:
SoapHeaderBinding ()

public SoapHeaderBinding ()

JScript

public function SoapHeaderBinding ()

プラットフォーム

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

参照

SoapHeaderBinding プロパティ

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

	名前	説明
	Encoding	SOAP ヘッダーをエンコードするために使用されるエンコーディングスタイルを表す URI を取得または設定します。
	Fault	SOAP ヘッダーの headerfault XML 要素の WSDL ドキュメントへの出力を制御する拡張機能の種類を取得または設定します。
	Handled	機能拡張要素のインポート時に、ServiceDescriptionFormatExtension がインポートプロセスで使用されるかどうかを示す値を取得または設定します。 ( ServiceDescriptionFormatExtension から継承されます。)
	MapToProperty	SoapHeaderBinding インスタンスを、生成されたプロキシクラスの特定のプロパティに割り当てるかどうかを示す値を取得または設定します。
	Message	SoapHeaderBinding が適用される、XML Web サービス内の Message の名前を指定する値を取得または設定します。
	Namespace	Encoding プロパティで特に定義されていない内容のエンコーディングについて記述された仕様の配置場所を表す URI を取得または設定します。
	Parent	ServiceDescriptionFormatExtension の親を取得します。 ( ServiceDescriptionFormatExtension から継承されます。)
	Part	SoapHeaderBinding が適用される、XML Web サービス内の MessagePart を示す値を取得または設定します。
	Required	ServiceDescriptionFormatExtension が参照先のアクションに必要かどうかを示す値を取得または設定します。 ( ServiceDescriptionFormatExtension から継承されます。)
	Use	ヘッダーを、Encoding プロパティによって指定された規則を使用してエンコードするか、具象 XML スキーマ内にカプセル化するかを指定します。

参照

SoapHeaderBinding メソッド

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

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

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

参照

SoapHeaderBinding メンバ

XML Web サービス内の InputBinding または OutputBinding に追加される拡張要素を表します。

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

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

	名前	説明
	SoapHeaderBinding

パブリックプロパティ

	名前	説明
	Encoding	SOAP ヘッダーをエンコードするために使用されるエンコーディングスタイルを表す URI を取得または設定します。
	Fault	SOAP ヘッダーの headerfault XML 要素の WSDL ドキュメントへの出力を制御する拡張機能の種類を取得または設定します。
	Handled	機能拡張要素のインポート時に、ServiceDescriptionFormatExtension がインポートプロセスで使用されるかどうかを示す値を取得または設定します。(ServiceDescriptionFormatExtension から継承されます。)
	MapToProperty	SoapHeaderBinding インスタンスを、生成されたプロキシクラスの特定のプロパティに割り当てるかどうかを示す値を取得または設定します。
	Message	SoapHeaderBinding が適用される、XML Web サービス内の Message の名前を指定する値を取得または設定します。
	Namespace	Encoding プロパティで特に定義されていない内容のエンコーディングについて記述された仕様の配置場所を表す URI を取得または設定します。
	Parent	ServiceDescriptionFormatExtension の親を取得します。(ServiceDescriptionFormatExtension から継承されます。)
	Part	SoapHeaderBinding が適用される、XML Web サービス内の MessagePart を示す値を取得または設定します。
	Required	ServiceDescriptionFormatExtension が参照先のアクションに必要かどうかを示す値を取得または設定します。(ServiceDescriptionFormatExtension から継承されます。)
	Use	ヘッダーを、Encoding プロパティによって指定された規則を使用してエンコードするか、具象 XML スキーマ内にカプセル化するかを指定します。

パブリックメソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

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

参照

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

SoapHeaderBinding クラス

SoapHeaderBinding コンストラクタ

.NET Framework

関連項目

SoapHeaderBinding プロパティ

関連項目

SoapHeaderBinding メソッド

関連項目

SoapHeaderBinding メンバ

関連項目

「SoapHeaderBinding」の関連用語


	© 2024 Microsoft.All rights reserved.

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

SoapHeaderBinding クラス

SoapHeaderBinding コンストラクタ

.NET Framework

関連項目

SoapHeaderBinding プロパティ

関連項目

SoapHeaderBinding メソッド

関連項目

SoapHeaderBinding メンバ

関連項目

急上昇のことば

「SoapHeaderBinding」の関連用語

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