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

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

SoapFormatter クラス

オブジェクト、または連結された複数のオブジェクトから成るグラフ全体を、SOAP 形式でシリアル化および逆シリアル化します。

名前空間: System.Runtime.Serialization.Formatters.Soap
アセンブリ: System.Runtime.Serialization.Formatters.Soap (system.runtime.serialization.formatters.soap.dll 内)
構文構文

Visual Basic (宣言)
Public NotInheritable Class
 SoapFormatter
    Implements IRemotingFormatter, IFormatter
Visual Basic (使用法)
Dim instance As SoapFormatter
C#
public sealed class SoapFormatter : IRemotingFormatter,
 IFormatter
C++
public ref class SoapFormatter sealed : IRemotingFormatter,
 IFormatter
J#
public final class SoapFormatter implements
 IRemotingFormatter, IFormatter
JScript
public final class SoapFormatter implements
 IRemotingFormatter, IFormatter
解説解説

SoapFormatter クラスおよび BinaryFormatter クラスは、IRemotingFormatter インターフェイスを実装してリモート プロシージャ コール (RPC: Remote Procedure Call) をサポートし、IFormatter インターフェイス (IRemotingFormatter によって継承される) を実装してオブジェクト グラフのシリアル化をサポートしています。SoapFormatter クラスは ISoapMessage オブジェクトを使用した RPC もサポートしますが、この場合は IRemotingFormatter 機能は使用しません。

IRemotingFormatter インターフェイスでは、RPC 時に、シリアル化するオブジェクトのグラフと、リモート関数呼び出しに関する情報 (トランザクション ID やメソッド シグネチャなど) を伝達するヘッダー オブジェクトの配列を格納する追加のグラフという、2 つの別個のグラフを指定できます。シリアル化を適切に実行するには、最初のグラフのルート オブジェクトを IMethodCallMessage インターフェイスまたは IMethodReturnMessage インターフェイスを実装するオブジェクトにする必要があります。

RPC の逆シリアル化時には、HeaderHandler デリゲートがフォーマッタの Deserialize メソッドに対して指定されます。リモート処理インフラストラクチャは、HeaderHandler デリゲートを使用して、ISerializable インターフェイスをサポートするオブジェクトを生成します。このオブジェクトは、ヘッダーに格納されている情報を保持し、デシリアライザによって返されるグラフのルートになります。

SoapFormatter は、ISoapMessage インターフェイスを実装しているオブジェクトを使用して生成された RPC も処理できます。IRemotingFormatter 機能を使用せずに RPC を作成するには、ISoapMessage インターフェイスをサポートするオブジェクトを、シリアル化されるグラフのルートに配置します。この方法で作成した RPC を逆シリアル化するには、ISoapMessage インターフェイスをサポートし、関連するリモート呼び出し情報を格納した別のオブジェクトを TopObject プロパティに指定する必要があります。

TimeSpan のシリアル化

TimeSpan オブジェクトは、「ISO 8601: 1998」セクション 5.5.3.2.1 の "代替" 標準に従ってシリアル化されます。

バージョン情報

SoapFormatter では、異なる .NET Framework バージョン間におけるシリアル化の互換性はサポートされません。Framework のバージョン 1.1 とバージョン 2.0 との間で型をシリアル化した場合、エラーが発生する場合があります。この問題については、次の方法で対処できます。

使用例使用例
Visual Basic
Imports System.IO
Imports System.Collections
Imports System.Runtime.Serialization

' Note: When building this code, you must reference the
' System.Runtime.Serialization.Formatters.Soap.dll assembly.
Imports System.Runtime.Serialization.Formatters.Soap


Module App

   Sub Main()
      Serialize()
      Deserialize()
   End Sub

   Sub Serialize()
      ' Create a hashtable of values that will eventually be serialized.
      Dim addresses As New
 Hashtable
      addresses.Add("Jeff", "123
 Main Street, Redmond, WA 98052")
      addresses.Add("Fred", "987
 Pine Road, Phila., PA 19116")
      addresses.Add("Mary", "PO
 Box 112233, Palo Alto, CA 94301")

      ' To serialize the hashtable (and its key/value pairs), 
      ' you must first open a stream for writing.
      ' Use a file stream here.
      Dim fs As New FileStream("DataFile.soap",
 FileMode.Create)

      ' Construct a SoapFormatter and use it 
      ' to serialize the data to the stream.
      Dim formatter As New
 SoapFormatter
      Try
         formatter.Serialize(fs, addresses)
      Catch e As SerializationException
         Console.WriteLine("Failed to serialize. Reason: "
 & e.Message)
         Throw
      Finally
         fs.Close()
      End Try
   End Sub


   Sub Deserialize()
      ' Declare the hashtable reference.
      Dim addresses As Hashtable = Nothing

      ' Open the file containing the data that you want to deserialize.
      Dim fs As New FileStream("DataFile.soap",
 FileMode.Open)
      Try
         Dim formatter As New
 SoapFormatter

         ' Deserialize the hashtable from the file and 
         ' assign the reference to the local variable.
         addresses = DirectCast(formatter.Deserialize(fs), Hashtable)
      Catch e As SerializationException
         Console.WriteLine("Failed to deserialize. Reason: "
 & e.Message)
         Throw
      Finally
         fs.Close()
      End Try

      ' To prove that the table deserialized correctly, 
      ' display the key/value pairs to the console.
      Dim de As DictionaryEntry
      For Each de In addresses
         Console.WriteLine("{0} lives at {1}.", de.Key,
 de.Value)
      Next
   End Sub
End Module
C#
using System;
using System.IO;
using System.Collections;
using System.Runtime.Serialization;

// Note: When building this code, you must reference the
// System.Runtime.Serialization.Formatters.Soap.dll assembly.
using System.Runtime.Serialization.Formatters.Soap;


class App 
{
    [STAThread]
    static void Main() 
    {
        Serialize();
        Deserialize();
    }

    static void Serialize() 
    {
        // Create a hashtable of values that will eventually be serialized.
        Hashtable addresses = new Hashtable();
        addresses.Add("Jeff", "123 Main Street, Redmond, WA 98052");
        addresses.Add("Fred", "987 Pine Road, Phila., PA 19116");
        addresses.Add("Mary", "PO Box 112233, Palo Alto, CA 94301");

        // To serialize the hashtable (and its key/value pairs), 
        // you must first open a stream for writing.
        // Use a file stream here.
        FileStream fs = new FileStream("DataFile.soap",
 FileMode.Create);

        // Construct a SoapFormatter and use it 
        // to serialize the data to the stream.
        SoapFormatter formatter = new SoapFormatter();
        try 
        {
            formatter.Serialize(fs, addresses);
        }
        catch (SerializationException e) 
        {
            Console.WriteLine("Failed to serialize. Reason: " + e.Message);
            throw;
        }
        finally 
        {
            fs.Close();
        }
    }

   
    static void Deserialize() 
    {
        // Declare the hashtable reference.
        Hashtable addresses  = null;

        // Open the file containing the data that you want to deserialize.
        FileStream fs = new FileStream("DataFile.soap",
 FileMode.Open);
        try 
        {
            SoapFormatter formatter = new SoapFormatter();

            // Deserialize the hashtable from the file and 
            // assign the reference to the local variable.
            addresses = (Hashtable) formatter.Deserialize(fs);
        }
        catch (SerializationException e) 
        {
            Console.WriteLine("Failed to deserialize. Reason: " + e.Message);
            throw;
        }
        finally 
        {
            fs.Close();
        }

        // To prove that the table deserialized correctly, 
        // display the key/value pairs to the console.
        foreach (DictionaryEntry de in addresses)
 
        {
            Console.WriteLine("{0} lives at {1}.", de.Key, de.Value);
        }
    }
}
C++
#using <system.dll>
#using <system.runtime.serialization.formatters.soap.dll>

using namespace System;
using namespace System::IO;
using namespace System::Collections;
using namespace System::Runtime::Serialization;
using namespace System::Runtime::Serialization::Formatters::Soap;
void Serialize()
{
   
   // Create a hashtable of values that will eventually be serialized.
   Hashtable^ addresses = gcnew Hashtable;
   addresses->Add( "Jeff", "123 Main Street, Redmond, WA 98052"
 );
   addresses->Add( "Fred", "987 Pine Road, Phila., PA 19116"
 );
   addresses->Add( "Mary", "PO Box 112233, Palo Alto, CA 94301"
 );
   
   // To serialize the hashtable (and its keys/values), 
   // you must first open a stream for writing.
   // We will use a file stream here.
   FileStream^ fs = gcnew FileStream( "DataFile.soap",FileMode::Create
 );
   
   // Construct a SoapFormatter and use it 
   // to serialize the data to the stream.
   SoapFormatter^ formatter = gcnew SoapFormatter;
   try
   {
      formatter->Serialize( fs, addresses );
   }
   catch ( SerializationException^ e ) 
   {
      Console::WriteLine( "Failed to serialize. Reason: {0}", e->Message
 );
      throw;
   }
   finally
   {
      fs->Close();
   }

}

void Deserialize()
{
   
   // Declare the hashtable reference.
   Hashtable^ addresses = nullptr;
   
   // Open the file containing the data that we want to deserialize.
   FileStream^ fs = gcnew FileStream( "DataFile.soap",FileMode::Open );
   try
   {
      SoapFormatter^ formatter = gcnew SoapFormatter;
      
      // Deserialize the hashtable from the file and 
      // assign the reference to our local variable.
      addresses = dynamic_cast<Hashtable^>(formatter->Deserialize( fs ));
   }
   catch ( SerializationException^ e ) 
   {
      Console::WriteLine( "Failed to deserialize. Reason: {0}", e->Message
 );
      throw;
   }
   finally
   {
      fs->Close();
   }

   
   // To prove that the table deserialized correctly, 
   // display the keys/values to the console.
   IEnumerator^ myEnum = addresses->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DictionaryEntry^ de = safe_cast<DictionaryEntry^>(myEnum->Current);
      Console::WriteLine( " {0} lives at {1}.", de->Key, de->Value
 );
   }
}


[STAThread]
int main()
{
   Serialize();
   Deserialize();
}
J#
import System.*;
import System.IO.*;
import System.Collections.*;
import System.Runtime.Serialization.*;
// Note: When building this code, you must reference the
// System.Runtime.Serialization.Formatters.Soap.dll assembly.
import System.Runtime.Serialization.Formatters.Soap.*;

class App
{
    /** @attribute STAThread()
     */
    public static void main(String[]
 args) throws SerializationException
    {
        Serialize();
        Deserialize();
    } //main

    static void Serialize() throws SerializationException
    {
        // Create a hashtable of values that will eventually be serialized.
        Hashtable addresses = new Hashtable();
        addresses.Add("Jeff", "123 Main Street, Redmond, WA 98052");
        addresses.Add("Fred", "987 Pine Road, Phila., PA 19116");
        addresses.Add("Mary", "PO Box 112233, Palo Alto, CA 94301");
        // To serialize the hashtable (and its key/value pairs), 
        // you must first open a stream for writing.
        // Use a file stream here.
        FileStream fs = new FileStream("DataFile.soap",
 FileMode.Create);
        // Construct a SoapFormatter and use it 
        // to serialize the data to the stream.
        SoapFormatter formatter = new SoapFormatter();
        try {
            formatter.Serialize(fs, addresses);
        }
        catch (SerializationException e) {
            Console.WriteLine("Failed to serialize. Reason: " 
                + e.get_Message());
            throw e;
        }
        finally {
            fs.Close();
        }
    } //Serialize

    static void Deserialize() throws SerializationException
    {
        // Declare the hashtable reference.
        Hashtable addresses = null;
        // Open the file containing the data that you want to deserialize.
        FileStream fs = new FileStream("DataFile.soap",
 FileMode.Open);
        try {
            SoapFormatter formatter = new SoapFormatter();
            // Deserialize the hashtable from the file and 
            // assign the reference to the local variable.
            addresses = (Hashtable)formatter.Deserialize(fs);
        }
        catch (SerializationException e) {
            Console.WriteLine("Failed to deserialize. Reason: " 
                + e.get_Message());
            throw e;
        }
        finally {
            fs.Close();
        }
        
        // To prove that the table deserialized correctly, 
        // display the key/value pairs to the console.
        IEnumerator myEnumerator = addresses.GetEnumerator();
        while (myEnumerator.MoveNext()) {
            DictionaryEntry de = (DictionaryEntry)myEnumerator.get_Current();
            Console.WriteLine("{0} lives at {1}.", de.get_Key(), 
                de.get_Value());
        }
    } //Deserialize
} //App
継承階層継承階層
System.Object
  System.Runtime.Serialization.Formatters.Soap.SoapFormatter
スレッド セーフスレッド セーフ
この型の 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
参照参照
関連項目
SoapFormatter メンバ
System.Runtime.Serialization.Formatters.Soap 名前空間

SoapFormatter コンストラクタ ()

SoapFormatter クラスの新しいインスタンスを既定のプロパティ値で初期化します。

名前空間: System.Runtime.Serialization.Formatters.Soap
アセンブリ: System.Runtime.Serialization.Formatters.Soap (system.runtime.serialization.formatters.soap.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New
Visual Basic (使用法)
Dim instance As New SoapFormatter
C#
public SoapFormatter ()
C++
public:
SoapFormatter ()
J#
public SoapFormatter ()
JScript
public function SoapFormatter ()
解説解説

SoapFormatter のインスタンスの初期プロパティ値を次の表に示します。

プロパティ

値

SurrogateSelector

null 参照 (Visual Basic では Nothing)

Context

シリアル化されたデータを他の任意のコンテキストとの間で送受信できることを指定するように初期化されている新しい StreamingContext
使用例使用例
Visual Basic
Imports System.IO
Imports System.Collections
Imports System.Runtime.Serialization

' Note: When building this code, you must reference the
' System.Runtime.Serialization.Formatters.Soap.dll assembly.
Imports System.Runtime.Serialization.Formatters.Soap


Module App

   Sub Main()
      Serialize()
      Deserialize()
   End Sub

   Sub Serialize()
      ' Create a hashtable of values that will eventually be serialized.
      Dim addresses As New
 Hashtable
      addresses.Add("Jeff", "123
 Main Street, Redmond, WA 98052")
      addresses.Add("Fred", "987
 Pine Road, Phila., PA 19116")
      addresses.Add("Mary", "PO
 Box 112233, Palo Alto, CA 94301")

      ' To serialize the hashtable (and its key/value pairs), 
      ' you must first open a stream for writing.
      ' Use a file stream here.
      Dim fs As New FileStream("DataFile.soap",
 FileMode.Create)

      ' Construct a SoapFormatter and use it 
      ' to serialize the data to the stream.
      Dim formatter As New
 SoapFormatter
      Try
         formatter.Serialize(fs, addresses)
      Catch e As SerializationException
         Console.WriteLine("Failed to serialize. Reason: "
 & e.Message)
         Throw
      Finally
         fs.Close()
      End Try
   End Sub


   Sub Deserialize()
      ' Declare the hashtable reference.
      Dim addresses As Hashtable = Nothing

      ' Open the file containing the data that you want to deserialize.
      Dim fs As New FileStream("DataFile.soap",
 FileMode.Open)
      Try
         Dim formatter As New
 SoapFormatter

         ' Deserialize the hashtable from the file and 
         ' assign the reference to the local variable.
         addresses = DirectCast(formatter.Deserialize(fs), Hashtable)
      Catch e As SerializationException
         Console.WriteLine("Failed to deserialize. Reason: "
 & e.Message)
         Throw
      Finally
         fs.Close()
      End Try

      ' To prove that the table deserialized correctly, 
      ' display the key/value pairs to the console.
      Dim de As DictionaryEntry
      For Each de In addresses
         Console.WriteLine("{0} lives at {1}.", de.Key,
 de.Value)
      Next
   End Sub
End Module
C#
using System;
using System.IO;
using System.Collections;
using System.Runtime.Serialization;

// Note: When building this code, you must reference the
// System.Runtime.Serialization.Formatters.Soap.dll assembly.
using System.Runtime.Serialization.Formatters.Soap;


class App 
{
    [STAThread]
    static void Main() 
    {
        Serialize();
        Deserialize();
    }

    static void Serialize() 
    {
        // Create a hashtable of values that will eventually be serialized.
        Hashtable addresses = new Hashtable();
        addresses.Add("Jeff", "123 Main Street, Redmond, WA 98052");
        addresses.Add("Fred", "987 Pine Road, Phila., PA 19116");
        addresses.Add("Mary", "PO Box 112233, Palo Alto, CA 94301");

        // To serialize the hashtable (and its key/value pairs), 
        // you must first open a stream for writing.
        // Use a file stream here.
        FileStream fs = new FileStream("DataFile.soap",
 FileMode.Create);

        // Construct a SoapFormatter and use it 
        // to serialize the data to the stream.
        SoapFormatter formatter = new SoapFormatter();
        try 
        {
            formatter.Serialize(fs, addresses);
        }
        catch (SerializationException e) 
        {
            Console.WriteLine("Failed to serialize. Reason: " + e.Message);
            throw;
        }
        finally 
        {
            fs.Close();
        }
    }

   
    static void Deserialize() 
    {
        // Declare the hashtable reference.
        Hashtable addresses  = null;

        // Open the file containing the data that you want to deserialize.
        FileStream fs = new FileStream("DataFile.soap",
 FileMode.Open);
        try 
        {
            SoapFormatter formatter = new SoapFormatter();

            // Deserialize the hashtable from the file and 
            // assign the reference to the local variable.
            addresses = (Hashtable) formatter.Deserialize(fs);
        }
        catch (SerializationException e) 
        {
            Console.WriteLine("Failed to deserialize. Reason: " + e.Message);
            throw;
        }
        finally 
        {
            fs.Close();
        }

        // To prove that the table deserialized correctly, 
        // display the key/value pairs to the console.
        foreach (DictionaryEntry de in addresses)
 
        {
            Console.WriteLine("{0} lives at {1}.", de.Key, de.Value);
        }
    }
}
C++
#using <system.dll>
#using <system.runtime.serialization.formatters.soap.dll>

using namespace System;
using namespace System::IO;
using namespace System::Collections;
using namespace System::Runtime::Serialization;
using namespace System::Runtime::Serialization::Formatters::Soap;
void Serialize()
{
   
   // Create a hashtable of values that will eventually be serialized.
   Hashtable^ addresses = gcnew Hashtable;
   addresses->Add( "Jeff", "123 Main Street, Redmond, WA 98052"
 );
   addresses->Add( "Fred", "987 Pine Road, Phila., PA 19116"
 );
   addresses->Add( "Mary", "PO Box 112233, Palo Alto, CA 94301"
 );
   
   // To serialize the hashtable (and its keys/values), 
   // you must first open a stream for writing.
   // We will use a file stream here.
   FileStream^ fs = gcnew FileStream( "DataFile.soap",FileMode::Create
 );
   
   // Construct a SoapFormatter and use it 
   // to serialize the data to the stream.
   SoapFormatter^ formatter = gcnew SoapFormatter;
   try
   {
      formatter->Serialize( fs, addresses );
   }
   catch ( SerializationException^ e ) 
   {
      Console::WriteLine( "Failed to serialize. Reason: {0}", e->Message
 );
      throw;
   }
   finally
   {
      fs->Close();
   }

}

void Deserialize()
{
   
   // Declare the hashtable reference.
   Hashtable^ addresses = nullptr;
   
   // Open the file containing the data that we want to deserialize.
   FileStream^ fs = gcnew FileStream( "DataFile.soap",FileMode::Open );
   try
   {
      SoapFormatter^ formatter = gcnew SoapFormatter;
      
      // Deserialize the hashtable from the file and 
      // assign the reference to our local variable.
      addresses = dynamic_cast<Hashtable^>(formatter->Deserialize( fs ));
   }
   catch ( SerializationException^ e ) 
   {
      Console::WriteLine( "Failed to deserialize. Reason: {0}", e->Message
 );
      throw;
   }
   finally
   {
      fs->Close();
   }

   
   // To prove that the table deserialized correctly, 
   // display the keys/values to the console.
   IEnumerator^ myEnum = addresses->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DictionaryEntry^ de = safe_cast<DictionaryEntry^>(myEnum->Current);
      Console::WriteLine( " {0} lives at {1}.", de->Key, de->Value
 );
   }
}


[STAThread]
int main()
{
   Serialize();
   Deserialize();
}
J#
import System.*;
import System.IO.*;
import System.Collections.*;
import System.Runtime.Serialization.*;
// Note: When building this code, you must reference the
// System.Runtime.Serialization.Formatters.Soap.dll assembly.
import System.Runtime.Serialization.Formatters.Soap.*;

class App
{
    /** @attribute STAThread()
     */
    public static void main(String[]
 args) throws SerializationException
    {
        Serialize();
        Deserialize();
    } //main

    static void Serialize() throws SerializationException
    {
        // Create a hashtable of values that will eventually be serialized.
        Hashtable addresses = new Hashtable();
        addresses.Add("Jeff", "123 Main Street, Redmond, WA 98052");
        addresses.Add("Fred", "987 Pine Road, Phila., PA 19116");
        addresses.Add("Mary", "PO Box 112233, Palo Alto, CA 94301");
        // To serialize the hashtable (and its key/value pairs), 
        // you must first open a stream for writing.
        // Use a file stream here.
        FileStream fs = new FileStream("DataFile.soap",
 FileMode.Create);
        // Construct a SoapFormatter and use it 
        // to serialize the data to the stream.
        SoapFormatter formatter = new SoapFormatter();
        try {
            formatter.Serialize(fs, addresses);
        }
        catch (SerializationException e) {
            Console.WriteLine("Failed to serialize. Reason: " 
                + e.get_Message());
            throw e;
        }
        finally {
            fs.Close();
        }
    } //Serialize

    static void Deserialize() throws SerializationException
    {
        // Declare the hashtable reference.
        Hashtable addresses = null;
        // Open the file containing the data that you want to deserialize.
        FileStream fs = new FileStream("DataFile.soap",
 FileMode.Open);
        try {
            SoapFormatter formatter = new SoapFormatter();
            // Deserialize the hashtable from the file and 
            // assign the reference to the local variable.
            addresses = (Hashtable)formatter.Deserialize(fs);
        }
        catch (SerializationException e) {
            Console.WriteLine("Failed to deserialize. Reason: " 
                + e.get_Message());
            throw e;
        }
        finally {
            fs.Close();
        }
        
        // To prove that the table deserialized correctly, 
        // display the key/value pairs to the console.
        IEnumerator myEnumerator = addresses.GetEnumerator();
        while (myEnumerator.MoveNext()) {
            DictionaryEntry de = (DictionaryEntry)myEnumerator.get_Current();
            Console.WriteLine("{0} lives at {1}.", de.get_Key(), 
                de.get_Value());
        }
    } //Deserialize
} //App
.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム

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
参照参照
関連項目
SoapFormatter クラス
SoapFormatter メンバ
System.Runtime.Serialization.Formatters.Soap 名前空間

SoapFormatter コンストラクタ (ISurrogateSelector, StreamingContext)

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

名前空間: System.Runtime.Serialization.Formatters.Soap
アセンブリ: System.Runtime.Serialization.Formatters.Soap (system.runtime.serialization.formatters.soap.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New ( _
    selector As ISurrogateSelector, _
    context As StreamingContext _
)
Visual Basic (使用法)
Dim selector As ISurrogateSelector
Dim context As StreamingContext

Dim instance As New SoapFormatter(selector,
 context)
C#
public SoapFormatter (
    ISurrogateSelector selector,
    StreamingContext context
)
C++
public:
SoapFormatter (
    ISurrogateSelector^ selector, 
    StreamingContext context
)
J#
public SoapFormatter (
    ISurrogateSelector selector, 
    StreamingContext context
)
JScript
public function SoapFormatter (
    selector : ISurrogateSelector, 
    context : StreamingContext
)

パラメータ

selector

SoapFormatter の新しいインスタンスで使用する ISurrogateSelector。null 参照 (Visual Basic では Nothing) でもかまいません。

context

シリアル化の転送元および転送先を保持する StreamingContext。context パラメータが null 参照 (Visual Basic では Nothing) の場合、Context は既定で CrossMachine に設定されます。

解説解説

オブジェクトは、指定した Stream を使用してシリアル化または逆シリアル化されます。

シリアル化処理または逆シリアル化処理では、指定した ISurrogateSelector を使用して、逆シリアル化するオブジェクト型用に登録されているサロゲートを検索します。サロゲートは、特定のクラスのオブジェクトをシリアル化および逆シリアル化するためのヘルパです。既定の ISurrogateSelector では、MarshalByRefObject から派生したオブジェクトをリモート処理の目的でシリアル化することはできません。リモート処理を行う場合は、指定した ISurrogateSelector が、MarshalByRefObject から派生したオブジェクトを、指定したサロゲート セレクタによってシリアル化された ObjRef オブジェクトに置換します。つまり、リモート オブジェクトを使用する場合は、selector パラメータに RemotingSurrogateSelector のインスタンスを設定します。サロゲートが不要な場合は、selector パラメータを null 参照 (Visual Basic では Nothing) に設定します。

.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム

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
参照参照
関連項目
SoapFormatter クラス
SoapFormatter メンバ
System.Runtime.Serialization.Formatters.Soap 名前空間
StreamingContext 構造体

SoapFormatter コンストラクタ

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

名前 説明
SoapFormatter () SoapFormatter クラスの新しいインスタンスを既定のプロパティ値で初期化します。
SoapFormatter (ISurrogateSelector, StreamingContext) 指定した ISurrogateSelector と StreamingContext を使用して、SoapFormatter クラスの新しいインスタンスを初期化します。
参照参照

関連項目

SoapFormatter クラス
SoapFormatter メンバ
System.Runtime.Serialization.Formatters.Soap 名前空間

SoapFormatter プロパティ


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

  名前 説明
パブリック プロパティ AssemblyFormat アセンブリの検索と読み込みに関するデシリアライザの動作を取得または設定します。
パブリック プロパティ Binder シリアル化されたオブジェクトから型へのバインディングを制御する、SerializationBinder を取得または設定します。
パブリック プロパティ Context SoapFormatter で使用する StreamingContext を取得または設定します。
パブリック プロパティ FilterLevel .NET Framework のリモート処理用の自動逆シリアル化の TypeFilterLevel を取得または設定します。
パブリック プロパティ SurrogateSelector シリアル化中および逆シリアル化中に行われる型の置換を制御する SurrogateSelector を取得または設定します。
パブリック プロパティ TopObject SOAP の先頭オブジェクトの逆シリアル化先である ISoapMessage を取得または設定します。
パブリック プロパティ TypeFormat シリアル化されたストリームにおける型の記述のレイアウト形式を取得または設定します。
参照参照

関連項目

SoapFormatter クラス
System.Runtime.Serialization.Formatters.Soap 名前空間

SoapFormatter メソッド


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

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Deserialize オーバーロードされます。 ストリームをオブジェクト グラフに逆シリアル化します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド Serialize オーバーロードされます。 オブジェクト、または連結された複数のオブジェクトから成るグラフをシリアル化します。
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
参照参照

関連項目

SoapFormatter クラス
System.Runtime.Serialization.Formatters.Soap 名前空間

SoapFormatter メンバ

オブジェクト、または連結された複数のオブジェクトから成るグラフ全体を、SOAP 形式でシリアル化および逆シリアル化します。

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


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド SoapFormatter オーバーロードされます。 SoapFormatter クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ AssemblyFormat アセンブリの検索と読み込みに関するデシリアライザの動作を取得または設定します。
パブリック プロパティ Binder シリアル化されたオブジェクトから型へのバインディングを制御する、SerializationBinder を取得または設定します。
パブリック プロパティ Context SoapFormatter で使用する StreamingContext を取得または設定します。
パブリック プロパティ FilterLevel .NET Framework のリモート処理用の自動逆シリアル化の TypeFilterLevel を取得または設定します。
パブリック プロパティ SurrogateSelector シリアル化中および逆シリアル化中に行われる型の置換を制御する SurrogateSelector を取得または設定します。
パブリック プロパティ TopObject SOAP の先頭オブジェクトの逆シリアル化先である ISoapMessage を取得または設定します。
パブリック プロパティ TypeFormat シリアル化されたストリームにおける型の記述のレイアウト形式を取得または設定します。
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Deserialize オーバーロードされます。 ストリームをオブジェクト グラフに逆シリアル化します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド Serialize オーバーロードされます。 オブジェクト、または連結された複数のオブジェクトから成るグラフをシリアル化します。
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 (Object から継承されます。)
参照参照

関連項目

SoapFormatter クラス
System.Runtime.Serialization.Formatters.Soap 名前空間

急上昇のことば

宇野重吉
あざとい
しました
について
因果応報

英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「SoapFormatter」の関連用語

1
SoapFormatter.Deserialize メソッド
.NET Framework クラス ライブラリ リファレンス
96% |||||

2
SoapFormatter.Serialize メソッド
.NET Framework クラス ライブラリ リファレンス
78% |||||

3
RemotingSurrogateSelector プロパティ
.NET Framework クラス ライブラリ リファレンス
70% |||||

4
System.Runtime.Serialization.Formatters.Soap 名前空間
.NET Framework クラス ライブラリ リファレンス
70% |||||

5
SoapFormatter コンストラクタ ()
.NET Framework クラス ライブラリ リファレンス
56% |||||

6
SoapFormatter クラス
.NET Framework クラス ライブラリ リファレンス
52% |||||

7
OnDeserializedAttribute プロパティ
.NET Framework クラス ライブラリ リファレンス
52% |||||

8
OnDeserializingAttribute プロパティ
.NET Framework クラス ライブラリ リファレンス
52% |||||

9
OnSerializedAttribute プロパティ
.NET Framework クラス ライブラリ リファレンス
52% |||||

10
OnSerializingAttribute プロパティ
.NET Framework クラス ライブラリ リファレンス
52% |||||

SoapFormatterのお隣キーワード

SoapFieldAttribute プロパティ

SoapFieldAttribute メソッド

SoapFieldAttribute メンバ

SoapFieldAttribute.IsInteropXmlElement メソッド

SoapFieldAttribute.Order プロパティ

SoapFieldAttribute.XmlElementName プロパティ

SoapFormatter

SoapFormatter クラス

SoapFormatter コンストラクタ

SoapFormatter プロパティ

SoapFormatter メソッド

SoapFormatter メンバ

SoapFormatter.AssemblyFormat プロパティ

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


SoapFormatterのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS