SoapException.Actor Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets the piece of code that caused the exception.

Namespace:   System.Web.Services.Protocols
Assembly:  System.Web.Services (in System.Web.Services.dll)

member Actor : string with get

Property Value

Type: System.String

The piece of code that caused the exception.

The Actor property can only be set using one of the constructors that accepts an Actor argument.

When a SOAP request is made, the message is sent to a recipient, which is specified in a SOAP actor attribute. If an exception occurs within an XML Web service, the value of the SOAP actor attribute is assigned to the Actor property. For XML Web services created using ASP.NET, the URL to the XML Web service method is the value of the SOAP actor attribute and is returned in the Actor property.

For more information on the SOAP actor attribute, see the SOAP specification at http://www.w3.org/TR/SOAP/.

The following Web Form example calls the Math XML Web service method, which throws an exception if a division by zero occurs. When the exception is thrown, the Web Form catches the exception and outputs the exception details, including the Actor and Code properties, into an HtmlTable control.

No code example is currently available or this language may not be supported.

In order for the preceding Web Form to use the following Math Web Service example, a namespace of MyMath was specified during the creation of the proxy class.

.NET Framework
Available since 1.1
Return to top
Show: