SoapFaultBinding Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет элемент расширяемости, добавляемый в объект FaultBinding веб-службы XML.
public ref class SoapFaultBinding : System::Web::Services::Description::ServiceDescriptionFormatExtension
[System.Web.Services.Configuration.XmlFormatExtension("fault", "http://schemas.xmlsoap.org/wsdl/soap/", typeof(System.Web.Services.Description.FaultBinding))]
public class SoapFaultBinding : System.Web.Services.Description.ServiceDescriptionFormatExtension
[<System.Web.Services.Configuration.XmlFormatExtension("fault", "http://schemas.xmlsoap.org/wsdl/soap/", typeof(System.Web.Services.Description.FaultBinding))>]
type SoapFaultBinding = class
inherit ServiceDescriptionFormatExtension
Public Class SoapFaultBinding
Inherits ServiceDescriptionFormatExtension
- Наследование
- Производный
- Атрибуты
Примеры
#using <System.dll>
#using <System.Web.Services.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::Web::Services::Description;
int main()
{
try
{
// Input wsdl file.
String^ myInputWsdlFile = "SoapFaultBindingInput_cpp.wsdl";
// Output wsdl file.
String^ myOutputWsdlFile = "SoapFaultBindingOutput_cpp.wsdl";
// Initialize an instance of a 'ServiceDescription' object.
ServiceDescription^ myServiceDescription = ServiceDescription::Read( myInputWsdlFile );
// Get a SOAP binding object with binding name S"MyService1Soap".
Binding^ myBinding = myServiceDescription->Bindings[ "MyService1Soap" ];
// Create a new instance of 'SoapFaultBinding' class.
SoapFaultBinding^ mySoapFaultBinding = gcnew SoapFaultBinding;
// Encode fault message using rules specified by 'Encoding' property.
mySoapFaultBinding->Use = SoapBindingUse::Encoded;
// Set the URI representing the encoding style.
mySoapFaultBinding->Encoding = "http://tempuri.org/stockquote";
// Set the URI representing the location of the specification
// for encoding of content not defined by 'Encoding' property'.
mySoapFaultBinding->Namespace = "http://tempuri.org/stockquote";
// Create a new instance of 'FaultBinding'.
FaultBinding^ myFaultBinding = gcnew FaultBinding;
myFaultBinding->Name = "AddFaultbinding";
myFaultBinding->Extensions->Add( mySoapFaultBinding );
// Get existing 'OperationBinding' object.
OperationBinding^ myOperationBinding = myBinding->Operations[ 0 ];
myOperationBinding->Faults->Add( myFaultBinding );
// Create a new wsdl file.
myServiceDescription->Write( myOutputWsdlFile );
Console::WriteLine( "The new wsdl file created is : {0}", myOutputWsdlFile );
Console::WriteLine( "Proxy could be created using command : wsdl {0}", myOutputWsdlFile );
}
catch ( Exception^ e )
{
Console::WriteLine( "Error occurred : {0}", e->Message );
}
}
using System;
using System.Web.Services.Description;
public class MySoapFaultBindingSample
{
public static void Main()
{
try
{
// Input wsdl file.
string myInputWsdlFile="SoapFaultBindingInput_cs.wsdl";
// Output wsdl file.
string myOutputWsdlFile="SoapFaultBindingOutput_cs.wsdl";
// Initialize an instance of a 'ServiceDescription' object.
ServiceDescription myServiceDescription =
ServiceDescription.Read(myInputWsdlFile);
// Get a SOAP binding object with binding name "MyService1Soap".
Binding myBinding=myServiceDescription.Bindings["MyService1Soap"];
// Create a new instance of 'SoapFaultBinding' class.
SoapFaultBinding mySoapFaultBinding=new SoapFaultBinding();
// Encode fault message using rules specified by 'Encoding' property.
mySoapFaultBinding.Use=SoapBindingUse.Encoded;
// Set the URI representing the encoding style.
mySoapFaultBinding.Encoding="http://tempuri.org/stockquote";
// Set the URI representing the location of the specification
// for encoding of content not defined by 'Encoding' property'.
mySoapFaultBinding.Namespace="http://tempuri.org/stockquote";
// Create a new instance of 'FaultBinding'.
FaultBinding myFaultBinding=new FaultBinding();
myFaultBinding.Name="AddFaultbinding";
myFaultBinding.Extensions.Add(mySoapFaultBinding);
// Get existing 'OperationBinding' object.
OperationBinding myOperationBinding=myBinding.Operations[0];
myOperationBinding.Faults.Add(myFaultBinding);
// Create a new wsdl file.
myServiceDescription.Write(myOutputWsdlFile);
Console.WriteLine("The new wsdl file created is :"
+myOutputWsdlFile);
Console.WriteLine("Proxy could be created using command : wsdl "
+ myOutputWsdlFile);
}
catch(Exception e)
{
Console.WriteLine("Error occurred : "+e.Message);
}
}
}
Imports System.Web.Services.Description
Public Class MySoapFaultBindingSample
Public Shared Sub Main()
Try
' Input wsdl file.
Dim myInputWsdlFile As String = "SoapFaultBindingInput_vb.wsdl"
' Output wsdl file.
Dim myOutputWsdlFile As String = "SoapFaultBindingOutput_vb.wsdl"
' Initialize an instance of a 'ServiceDescription' object.
Dim myServiceDescription As ServiceDescription = ServiceDescription.Read(myInputWsdlFile)
' Get a SOAP binding object with binding name "MyService1Soap".
Dim myBinding As Binding = myServiceDescription.Bindings("MyService1Soap")
' Create a new instance of 'SoapFaultBinding' class.
Dim mySoapFaultBinding As New SoapFaultBinding()
' Encode fault message using rules specified by 'Encoding' property.
mySoapFaultBinding.Use = SoapBindingUse.Encoded
' Set the URI representing the encoding style.
mySoapFaultBinding.Encoding = "http://tempuri.org/stockquote"
' Set the URI representing the location of the specification
' for encoding of content not defined by 'Encoding' property'.
mySoapFaultBinding.Namespace = "http://tempuri.org/stockquote"
' Create a new instance of 'FaultBinding'.
Dim myFaultBinding As New FaultBinding()
myFaultBinding.Name = "AddFaultbinding"
myFaultBinding.Extensions.Add(mySoapFaultBinding)
' Get existing 'OperationBinding' object.
Dim myOperationBinding As OperationBinding = myBinding.Operations(0)
myOperationBinding.Faults.Add(myFaultBinding)
' Create a new wsdl file.
myServiceDescription.Write(myOutputWsdlFile)
Console.WriteLine("The new wsdl file created is :" + myOutputWsdlFile)
Console.WriteLine("Proxy could be created using command : wsdl /language:VB " + myOutputWsdlFile)
Catch e As Exception
Console.WriteLine("Error occurred : " + e.Message.ToString())
End Try
End Sub
End Class
Комментарии
Этот класс задает содержимое любого возвращаемого сообщения об ошибке SOAP.
Дополнительные сведения об указании протоколов для веб-служб XML см. в разделе Xml Web Services Using ASP.NET. Дополнительные сведения о языке описания веб-служб (WSDL) см. в спецификации WSDL .
Конструкторы
SoapFaultBinding() |
Инициализирует экземпляр класса SoapFaultBinding. |
Свойства
Encoding |
Получает или задает URI, представляющий стиль кодировки, который используется для кодирования сообщений SOAP о сбоях. |
Handled |
Возвращает или задает значение, показывающее, используется ли объект ServiceDescriptionFormatExtension при импорте элемента расширения среды. (Унаследовано от ServiceDescriptionFormatExtension) |
Name |
Получает или задает значение атрибута имени, которое связывает сбой SOAP со сбоем WDSL, определенным для заданной операции. |
Namespace |
Получает или задает URI, который указывает расположение спецификации для кодировки содержимого, не определенного отдельно свойством Encoding. |
Parent |
Возвращает родительский класс класса ServiceDescriptionFormatExtension. (Унаследовано от ServiceDescriptionFormatExtension) |
Required |
Возвращает или задает значение, показывающее, является ли класс ServiceDescriptionFormatExtension необходимым для действия, к которому он относится. (Унаследовано от ServiceDescriptionFormatExtension) |
Use |
Указывает, было ли сообщение о сбое закодировано при помощи правил, заданных свойством Encoding или оно было инкапсулировано в конкретную схему XML. |
Методы
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |