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.

SoapHeader الفئة

Visual Studio 2010

عند تجاوز في فئة مشتقة، يمثل محتويات عنوان بروتوكول بروتوكول SOAP.

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

public abstract class SoapHeader

رؤوس بروتوكول بروتوكول SOAP تقدم طريقة لتمرير بيانات إلى من أسلوب الخدمة ويب XML إذا كانت بيانات لا يرتبط بشكل مباشر و إلى وظائف أسلوب الخدمة ويب ل XML الأساسي. على سبيل المثال، الخدمة ويب XML قد يحتوي على عدة الخدمة ويب XML وظائف أن بعضها يتطلب نظام مصادقة مخصصة. بدلاً من إضافة معلمات إلى كل الخدمة ويب XML أسلوب لنظام مصادقة المخصصة، على SoapHeaderAttribute، قم بالإشارة إلى فئة اشتقاق من SoapHeader، يمكن تطبيقها على كل الخدمة ويب XML الأسلوب. تطبيق للفئة اشتقاق من SoapHeaderيتعامل مع نظام مصادقة المخصصة. بهذه الطريقة، يطبق أسلوب الخدمة ويب XML الخاصة وظيفة فقط إلى به وإضافة وظيفة إضافى باستخدام عنوان بروتوكول بروتوكول SOAP.

توضح القائمة التالية الخطوات أساسى إلى استقبال ومعالجة عنوان بروتوكول بروتوكول SOAP:

  1. إنشاء فئة مشتقة من SoapHeaderيمثل بيانات التي تمر في عنوان بروتوكول بروتوكول SOAP.

  2. إضافة عضو إلى الفئة بتنفيذ الخدمة ويب XML أو الخدمة ويب XML فئة الوكيل العميل من النوع تم إنشاؤه في الخطوة الأولى.

  3. يطبق SoapHeaderAttributeإلى الخدمة ويب XML أسلوب أو التابع لها أسلوب في فئة الوكيل، يحدد العضو إنشائه في الخطوة ثانية في MemberNameخاصية.

  4. ضمن أسلوب الخدمة ويب ل XML أو رمز عميل الخدمة ويب ل XML، الوصول إلى MemberNameبخاصية عملية بيانات المرسلة في عنوان بروتوكول بروتوكول SOAP.

التالي MyWebServiceالخدمة ويب XML يعرف MyHeaderبروتوكول بروتوكول SOAP الرأس ويتطلب أن يتم إرسالها دون أي استدعاءات MyWebMethodالخدمة ويب XML الأسلوب. بالإضافة إلى ذلك، MyWebMethodيتلقى أي رؤوس بروتوكول بروتوكول SOAP غير ذلك من MyHeaderعنوان بروتوكول بروتوكول SOAP.


<%@ WebService Language="C#" Class="MyWebService"%>
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Xml;
using System;

// Define a SOAP header by deriving from the SoapHeader base class.

public class MyHeader : SoapHeader {
    public string MyValue;
}

public class MyWebService {

    public MyHeader myHeader;
    // Receive all SOAP headers besides the MyHeader SOAP header.
    public SoapUnknownHeader[] unknownHeaders;

    [WebMethod]
    [SoapHeader("myHeader", Direction=SoapHeaderDirection.InOut)]

    //Receive any SOAP headers other than MyHeader.
    [SoapHeader("unknownHeaders",Required=false)]

    public string MyWebMethod() {

       foreach (SoapUnknownHeader header in unknownHeaders) {
           // Perform some processing on the header.
       if (header.Element.Name == "MyKnownHeader")
               header.DidUnderstand = true;
       else
                // For those headers that cannot be  
                // processed, set the DidUnderstand property to false.
                header.DidUnderstand = false;
       }
       return "Hello";
    }
}



يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في 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
إظهار: