Свойство Generated Proxy Classes defaultUserContext
Обновлен: Ноябрь 2007
Возвращает или задает для созданного класса прокси и его экземпляров используемый по умолчанию контекст пользователя. Это свойство существует во время выполнения, оно появляется после создания сервером класса прокси.
Примечание. |
---|
Чтобы получить или задать значения для свойств клиентского прикладного программного интерфейса (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);
Параметры
Параметр |
Описание |
---|---|
value |
Сведения о контексте пользователя, связанные с вызовом веб-службы. Значением value может быть null, любой простой тип или объект JavaScript. |
Возвращаемое значение
Сведения о контексте пользователя, связанные с запросом веб-службы, при его наличии; в противном случае — null.
Заметки
Объект контекста пользователя может передаваться как параметр функциям обратного вызова при успешном или неудачном завершении запроса во время любого вызова метода веб-службы. Дополнительные сведения см. в разделах Функция Generated Proxy Classes Succeeded Callback и Функция Generated Proxy Classes Failed Callback.
Если контекст пользователя передается при вызове метода веб-службы, передаваемое значение переопределяет значение, установленное в свойстве 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);
}