生成的代理类的 defaultUserContext 属性

更新：2007 年 11 月

获取或设置生成的代理类及其实例的默认用户上下文。此属性在服务器已生成代理类之后在运行时存在。

说明：
若要获取或设置客户端 API 属性的属性值，必须调用以 get_ 和 set_ 为名称前缀的属性访问器方法。例如，若要获取或设置属性 cancel 的值，需要调用 get_cancel 或 set_cancel 方法。

// Syntax for the generated proxy class.
var userContext = MyNameSpace.MyServiceProxy.get_defaultUserContext(); 
MyNameSpace.MyServiceProxy.set_defaultUserContext(value);

// Syntax for a proxy instance.
var userContext = myServiceProxy.get_defaultUserContext(); 
myServiceProxy.set_defaultUserContext(value);

参数

返回值

如果存在与 Web 服务请求关联的用户上下文信息，则返回该信息；否则返回 null。

备注

用户上下文对象可在任何 Web 服务方法调用过程中作为参数传递给成功或失败回调函数。有关更多信息，请参见生成的代理类成功回调函数和生成的代理类失败回调函数。

如果在调用 Web 服务方法时传递用户上下文，则传递的值将覆盖 defaultUserContext 属性所设置的值。

示例

下面的示例演示如何设置和获取生成的代理类和代理实例的 defaultUserContext 属性。

// This function sets and gets the default user context
// for the Web service generated proxy class.
function AssignUserContext() 
{
    // Define the user context.
    var userContext = "Proxy context.";

    // Set the default user context.
    Samples.AspNet.UsingProxyClass.set_defaultUserContext(userContext);

    // Get the default user context.
    userContext = 
        Samples.AspNet.UsingProxyClass.get_defaultUserContext();

    // Display the user context.
    DisplayMessage("The user context is: " + userContext);
}

// This function sets and gets the default user context
// for an instance of the Web service generated proxy class.
function AssignInstanceUserContext() 
{
    // Define the user context.
    var userContext = "Proxy instance context.";
    // Create an instance of the proxy class.
    var proxyInstance = 
        new Samples.AspNet.UsingProxyClass();

    // Set the default user context.
    proxyInstance.set_defaultUserContext(userContext);

    // Get the default user context.
    userContext = 
        proxyInstance.get_defaultUserContext();

    // Display the user context.
    DisplayMessage("The user context is: " + userContext);
}

请参见

概念

Sys.Net.WebServiceProxy 类

参考

生成的代理类成功回调函数

生成的代理类失败回调函数