OperationContractAttribute.ProtectionLevel Özellik

Tanım

Ad Alanı:

System.ServiceModel

Bütünleştirilmiş Kod:

System.ServiceModel.dll

bir işlemin iletilerinin şifrelenmesini, imzalanması mı yoksa her ikisini birden mi içermesi gerektiğini belirten bir değer alır veya ayarlar.

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

Özellik Değeri

ProtectionLevel

Değerlerden ProtectionLevel biri. Varsayılan değer: None.

Özel durumlar

ArgumentOutOfRangeException

Değer değerlerden biri ProtectionLevel değildir.

Açıklamalar

bir işlemin iletilerinin ProtectionLevel şifrelenip şifrelenmediğini, imzalanması veya her ikisinin birden yapılıp yapılmayacağını denetlemek için özelliğini kullanın. Burada ayarlanan değer, daha dar bir kapsam bu değeri geçersiz kılmadığı sürece bu işlem için belirtilen tüm iletiler için varsayılan değerdir.

Çalışma zamanındaki koruma davranışının, aşağıdaki özelliklerde ayarlanan koruma düzeyi değerlerin birleşimi olduğunu unutmayın. Bu özellikler hiyerarşik bir yapıya sahiptir. En dıştaki değerin ayarlanması, daha dar bir kapsam için farklı bir değer açıkça ayarlanmadığı sürece tüm dar kapsamlar için varsayılan ayarı belirler. Bu durumda dış değer, özel olarak ayarlanmış olan hariç tüm dar kapsamlar için varsayılan değer olarak kalır.

Örneğin, olarak ayarlanırsa ProtectionLevel.EncryptAndSign ve diğer dar kapsamların koruma düzeyi ayarları yoksaServiceContractAttribute.ProtectionLevel, işlem sözleşmesindeki tüm iletiler şifrelenir ve imzalanır. Bununla birlikte, bu işlemlerden ProtectionLevel biri olarak ayarlanmışsa ProtectionLevel.Sign, bu işlemin iletileri imzalanmış ancak sözleşmedeki diğer tüm iletiler şifrelenir ve imzalanmış olur.

Koruma düzeyleri ve bunların varsayımları ve kapsamları hakkında ayrıntılı bilgi için bkz. Koruma Düzeyini Anlama.

Bu değerlerin ayarlandığı kapsamlar şunlardır:

ServiceContractAttribute.ProtectionLevel

OperationContractAttribute.ProtectionLevel

FaultContractAttribute.ProtectionLevel

MessageContractAttribute.ProtectionLevel

MessageContractMemberAttribute.ProtectionLevel üzerindeki System.ServiceModel.MessageHeaderAttributeözelliği.

MessageContractMemberAttribute.ProtectionLevel üzerindeki System.ServiceModel.MessageBodyMemberAttributeözelliği.

Sözleşmede açıkça belirtilen bir koruma düzeyi olmadığında ve temel bağlama güvenliği (aktarım veya ileti düzeyinde) desteklediğinde, sözleşmenin tamamı için etkili koruma düzeyi olur ProtectionLevel.EncryptAndSign. Bağlama güvenliği (gibi BasicHttpBinding) System.Net.Security.ProtectionLevel desteklemiyorsa, geçerli olan ProtectionLevel.None sözleşmenin tamamı içindir. Sonuç, uç nokta bağlamaya bağlı olarak, sözleşme belirtse bile istemcilerin farklı ileti veya aktarım düzeyi güvenlik koruması gerektirebileceğidir ProtectionLevel.None.