ServiceContractAttribute.ProtectionLevel Vlastnost

Definice

Obor názvů:

System.ServiceModel

Sestavení:

System.ServiceModel.dll

Určuje, zda vazba kontraktu musí podporovat hodnotu ProtectionLevel vlastnosti.

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

Hodnota vlastnosti

ProtectionLevel

Jedna z ProtectionLevel hodnot. Výchozí hodnota je None.

Výjimky

ArgumentOutOfRangeException

Hodnota není jednou z ProtectionLevel hodnot.

Poznámky

ProtectionLevel Vlastnost použijte k určení stupně, ve kterém vazba kontraktu vyžaduje šifrování, digitální podpisy nebo obojí pro koncové body, které zpřístupňují kontrakt. Zde nastavená hodnota je výchozí hodnota pro všechny zprávy operací včetně chyb.

Je důležité si uvědomit, že chování ochrany za běhu je kombinací hodnot na úrovni ochrany nastavených pro následující vlastnosti. Tyto vlastnosti mají hierarchickou strukturu. Nastavení vnější hodnoty vytvoří výchozí nastavení pro všechny užší obory, pokud není explicitně nastavena jiná hodnota pro užší obor. V tomto případě zůstává vnější hodnota výchozím nastavením pro všechny užší obory s výjimkou této sady.

Pokud ServiceContractAttribute.ProtectionLevel je například nastavená ProtectionLevel.EncryptAndSign hodnota a žádné další užší obory nemají nastavení úrovně ochrany, všechny zprávy v kontraktu operace jsou šifrované a podepsané. Pokud je však jedna z těchto operací nastavena na OperationContractAttributeProtectionLevel.Sign, zprávy pro danou operaci jsou podepsány, ale všechny ostatní zprávy v kontraktu jsou zašifrovány a podepsány.

Podrobnosti o úrovních ochrany a jejich předpokladech a oborech najdete v tématu Principy úrovně ochrany.

Obory, na kterých jsou tyto hodnoty nastaveny:

ServiceContractAttribute.ProtectionLevel

OperationContractAttribute.ProtectionLevel

FaultContractAttribute.ProtectionLevel

MessageContractAttribute.ProtectionLevel

Vlastnost MessageContractMemberAttribute.ProtectionLevel na System.ServiceModel.MessageHeaderAttribute.

Vlastnost MessageContractMemberAttribute.ProtectionLevel na System.ServiceModel.MessageBodyMemberAttribute.

Pokud není u smlouvy explicitně zadána žádná úroveň ochrany a podkladová vazba podporuje zabezpečení (ať už na úrovni přenosu nebo zprávy), je ProtectionLevel.EncryptAndSignúčinná úroveň ochrany pro celou smlouvu . Pokud vazba nepodporuje zabezpečení (například BasicHttpBinding), platí System.Net.Security.ProtectionLevelProtectionLevel.None pro celou smlouvu. Výsledkem je to, že klienti mohou v závislosti na vazbě koncového bodu vyžadovat jinou ochranu zabezpečení na úrovni zprávy nebo přenosu, i když smlouva určuje ProtectionLevel.None.