WebServiceHelper.TryUrlRedirection Method

Redirects a Web service object to the ASP.NET Development Server instead of the resource that is defined in the provided Web reference.

Namespace:  Microsoft.VisualStudio.TestTools.UnitTesting
Assembly:  Microsoft.VisualStudio.QualityTools.UnitTestFramework (in Microsoft.VisualStudio.QualityTools.UnitTestFramework.dll)

Syntax

'Declaration
Public Shared Function TryUrlRedirection ( _
    client As WebClientProtocol, _
    context As TestContext, _
    identifier As String _
) As Boolean

public static bool TryUrlRedirection(
    WebClientProtocol client,
    TestContext context,
    string identifier
)

public:
static bool TryUrlRedirection(
    WebClientProtocol^ client, 
    TestContext^ context, 
    String^ identifier
)

static member TryUrlRedirection : 
        client:WebClientProtocol * 
        context:TestContext * 
        identifier:string -> bool

public static function TryUrlRedirection(
    client : WebClientProtocol, 
    context : TestContext, 
    identifier : String
) : boolean

Parameters

• client
  Type: WebClientProtocol

  An instance of the Web service type that is being tested.

• context
  Type: Microsoft.VisualStudio.TestTools.UnitTesting.TestContext

  The TestContext for this unit test.

• identifier
  Type: String

  A unique string that identifies an ASP.NET Development Server instance. This matches the name parameter of an AspNetDevelopmentServerAttribute on the test method.

Return Value

Type: Boolean
true if a redirect occurred; otherwise, false.

Remarks

When you run a test with an AspNetDevelopmentServerAttribute, an instance of an ASP.NET Development Server is started. This makes sure that an ASP.NET Development Server site is started and that you know the URL. When you run a test, you can then use TryUrlRedirection to redirect a Web service object so that it points to the known server instead of the resource that is defined in the provided Web reference. This method returns true if the redirection was successful, and false if it was not. For example, if the identifier did not match the name of an existing ASP.NET Development Server instance, the method returns false.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

WebServiceHelper Class

Microsoft.VisualStudio.TestTools.UnitTesting Namespace

TestContext

AspNetDevelopmentServerAttribut