共用方式為


MessageContractMemberAttribute.ProtectionLevel 屬性

定義

指定成員要依現狀加以傳輸、簽署,或者加以簽署並加密。

public:
 property System::Net::Security::ProtectionLevel ProtectionLevel { System::Net::Security::ProtectionLevel get(); void set(System::Net::Security::ProtectionLevel value); };
public System.Net.Security.ProtectionLevel ProtectionLevel { get; set; }
member this.ProtectionLevel : System.Net.Security.ProtectionLevel with get, set
Public Property ProtectionLevel As ProtectionLevel

屬性值

ProtectionLevel

其中一個 ProtectionLevel 值。 預設為 None

備註

若要使用 ProtectionLevelMessageHeaderAttribute 屬性中的 MessageBodyMemberAttribute 屬性,您必須正確設定繫結和行為。 如果沒有透過正確的組態 (例如,使用具有未提供安全性認證之訊息部分的 ProtectionLevel.Sign) 使用這些安全性功能,就會在執行階段擲回例外狀況。

此外,保護層級是針對每一個標頭個別決定的。 不過,無論有多少個本文部分,SOAP 本文都只有一個保護層級。 本文保護層級是由所有本文部分的最高層 ProtectionLevel 屬性值所決定。 例如,請參考下列類別:

[MessageContract]  
public class PatientRecord  
{  
   [MessageHeader(ProtectionLevel=None)] public int recordID;  
   [MessageHeader(ProtectionLevel=Sign)] public string patientName;  
   [MessageHeader(ProtectionLevel=EncryptAndSign)] public string SSN;  
   [MessageBody(ProtectionLevel=None)] public string comments;  
   [MessageBody(ProtectionLevel=Sign)] public string diagnosis;  
   [MessageBody(ProtectionLevel=EncryptAndSign)] public string medicalHistory;  
}  

在這個範例中,recordID 標頭不受保護,patientName 已經過簽署,而 SSN 已經過加密並簽署。 至少有一個本文部分 medicalHistory 具有 ProtectionLevel.EncryptAndSign,因此會加密並簽署整個訊息本文,即使 commentsdiagnosis 本文部分指定較低的保護層級亦然。

執行階段的保護行為,是下列屬性的保護層級設定值的組合。 這些屬性有階層式結構。 除非針對較窄的範圍明確設定不同的值,否則,設定最外層的值會建立所有較窄範圍的預設值。 在此情況下,外部值仍為所有較窄範圍的預設值 (特別設定的範圍除外)。

例如,如果 ServiceContractAttribute.ProtectionLevel 設定為 ProtectionLevel.EncryptAndSign 而且沒有其他更窄的範圍具有保護層級設定,則會加密並簽署作業合約中的所有訊息。 但是,如果這些其中一個作業已將 OperationContractAttribute 設定為 ProtectionLevel.Sign,則會簽署該作業的訊息,但是合約中的其他所有訊息都會經過加密並簽署。

如需保護層級及其假設和範圍的詳細資訊,請參閱 瞭解保護等級

設定這些值的範圍如下:

ServiceContractAttribute.ProtectionLevel

OperationContractAttribute.ProtectionLevel

FaultContractAttribute.ProtectionLevel

MessageContractAttribute.ProtectionLevel

MessageContractMemberAttribute.ProtectionLevelSystem.ServiceModel.MessageHeaderAttribute 屬性。

MessageContractMemberAttribute.ProtectionLevelSystem.ServiceModel.MessageBodyMemberAttribute 屬性。

當合約上未明確指定保護層級,而且基礎繫結可支援安全性 (不論是在傳輸層級或訊息層級) 時,整個合約的有效保護層級會是 ProtectionLevel.EncryptAndSign。 如果繫結不支援安全性 (例如,BasicHttpBinding),整個合約的有效 System.Net.Security.ProtectionLevelProtectionLevel.None。 結果便是根據端點繫結的不同,用戶端可以要求不同的訊息或傳輸層級的安全性保護,即使當合約指定 ProtectionLevel.None 時亦然。

適用於