This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

SoapDocumentMethodAttribute الفئة

Visual Studio 2010

تطبيق SoapDocumentMethodAttributeإلى تحديد أسلوب الذي الرسائل بروتوكول بروتوكول SOAP إلى ومن استخدام أسلوب Documentتنسيق.

مساحة الاسم:  System.Web.Services.Protocols
التجميع:  System.Web.Services (في System.Web.Services.dll)

[AttributeUsageAttribute(AttributeTargets.Method)]
public sealed class SoapDocumentMethodAttribute : Attribute

لغة وصف لخدمات ويب (WSDL) بتعريف أنماط الثاني لكيفية الخدمة ويب XML أسلوب، الذي يقوم باستدعاء عملية، يمكن منسقها في رسالة بروتوكول بروتوكول SOAP: RPC وDocument Document تشير إلى التنسيق الخدمة ويب XML أسلوب وفقا لعنصر مخطط XSD. Document النمط تشير إلى تنسيق Bodyعنصر كـ سلسلة من جزء واحد أو أكثر الرسالة التالية Bodyالعنصر. تماما كيفية أجزاء رسالة فردية هو تحديد بواسطة Useو ParameterStyleالخصائص. Use خاصية بتحديد ما إذا كان معلمات منسقة Encodedأو Literal. ParameterStyle يحدد ما إذا كان يتم تغليف المعلمات في يلي جزء رسالة واحدة Bodyالعنصر أو ما إذا كان كل معلمة هو part. رسالة فردية

ل المزيد التفاصيل، راجع [<topic://cpconCustomizingSOAPInASPNETWebServicesWebServiceClients>]

يمكن تطبيق هذه السمة إلى كلا XML أسلوب الخدمة ويب تشغيل الملقم وأسلوب من فئة الوكيل تشغيل كمبيوتر العميل.

The following تعليمات برمجية مثال sets the رسالة النمط إلى Document for the GetUserName XML ويب الخدمة أسلوب. عنصر XML بالإضافة إلى ذلك، بواسطة Bodyعنصر بروتوكول بروتوكول SOAP طلب واستجابة بروتوكول بروتوكول SOAP التي تم تعيينها إلى GetUserNameRequestو GetUserNameResponse، على التوالي.


<%@ WebService Language="C#" class="MyUser" %>
 using System;
 using System.Web.Services;
 using System.Web.Services.Protocols;

 public class MyUser : WebService {

       [ SoapDocumentMethod(Action="http://www.contoso.com/Sample", 
           RequestNamespace="http://www.contoso.com/Request",
           RequestElementName="GetUserNameRequest",
           ResponseNamespace="http://www.contoso.com/Response",
           ResponseElementName="GetUserNameResponse")]
      [ WebMethod(Description="Obtains the User Name") ]
      public UserName GetUserName() {
           string temp;
           int pos;
           UserName NewUser = new UserName();

           // Get the full user name, including the domain name if applicable.
           temp = User.Identity.Name;

           // Deterime whether the user is part of a domain by searching for a backslash.
           pos = temp.IndexOf("\\");

           // Parse the domain name out of the string, if one exists.
           if (pos <= 0)
                 NewUser.Name = User.Identity.Name;
           else {
               NewUser.Name = temp.Remove(0,pos+1);
                 NewUser.Domain = temp.Remove(pos,temp.Length-pos);
           } 
       return NewUser;
      }

 }   

 public class UserName {

     public string Name;
     public string Domain;
 }



System.Object
  System.Attribute
    System.Web.Services.Protocols.SoapDocumentMethodAttribute

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0, 1.1, 1.0

NET Framework. Client Profile

مدعوم في: 4
إظهار: