ScriptMethodAttribute Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.Script.Services

Bütünleştirilmiş Kod:: System.Web.Extensions.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bir yöntemi çağırmak için hangi HTTP fiilinin kullanıldığını ve yanıtın biçimini belirtir. Bu sınıf devralınamaz.

public ref class ScriptMethodAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class ScriptMethodAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method)>]
type ScriptMethodAttribute = class
    inherit Attribute

Public NotInheritable Class ScriptMethodAttribute
Inherits Attribute

Devralma: Object

Attribute
ScriptMethodAttribute

Öznitelikler: AttributeUsageAttribute

Örnekler

Aşağıdaki örnekte, hangi HTTP fiilinin GetXmlDocument kullanılacağını belirtmek ve yanıt biçimini belirtmek için ve EchoStringAndDate yöntemlerine nasıl uygulanacağı ScriptMethodAttribute gösterilmektedir.

Açıklamalar

Bu öznitelik, istemci betiğinden çağrılabilecek yöntemlerin bilgilerini belirtmek için kullanılır. özniteliği, bir yöntemi çağırmak için hangi HTTP fiilinin (GET veya POST) kullanılabileceğini belirtmenize olanak tanır. Ayrıca yanıtın JavaScript Nesne Gösterimi (JSON) veya XML kullanılarak biçimlendirilip biçimlendirilmeyeceğini belirtmenize de olanak tanır.

ScriptMethodAttribute özniteliği isteğe bağlıdır. (Ancak, istemci betiğinden çağrılabilen yöntemlerin System.Web.Services.WebMethodAttribute özniteliği uygulanmalıdır.). Bir yöntem ile ScriptMethodAttributeişaretlenmemişse, yöntem HTTP POST komutu kullanılarak çağrılır ve yanıt JSON olarak serileştirilir. Bu ayarı betikten geçersiz kılamazsınız.

ScriptMethodAttribute yalnızca adlandırılmış parametreleri alır. Sınıfın adlandırılmış parametreler olarak kullanılabilecek özellikleri ScriptMethodAttribute şunlardır:

UseHttpGet

yönteminin HTTP GET komutu kullanılarak çağrılıp çağrılmayacağını belirtir. Varsayılan değer: false.

Önemli

Özelliğini true olarak UseHttpGet ayarlamak, hassas verilerle veya işlemlerle çalışıyorsanız uygulamanız için güvenlik riski doğurabilir. GET isteklerinde, ileti tarayıcı tarafından URL'ye kodlanır ve bu nedenle kurcalama için daha kolay bir hedeftir. Hem GET hem de POST isteklerinde, hassas verileri korumak için güvenlik yönergelerini izlemeniz gerekir.
ResponseFormat

Yanıtın JSON olarak mı yoksa XML olarak mı serileştirileceğini belirtir. Varsayılan değer: Json. ResponseFormat özelliği, yöntem bir XmlDocument veya XmlElement nesnesi döndürdüğünde dönüş türü olarak XML belirtmek için yararlıdır.
XmlSerializeString

Dize türleri de dahil olmak üzere tüm dönüş türlerinin XML olarak serileştirilip serileştirilmeyeceğini belirtir. Yanıt JSON olarak seri hale getirildiğinde özelliğin değeri XmlSerializeString yoksayılır.

Öznitelikleri kullanma hakkında daha fazla bilgi için bkz . Öznitelikler.

Oluşturucular

ScriptMethodAttribute()

ScriptMethodAttribute sınıfının yeni bir örneğini başlatır.

Özellikler

ResponseFormat	Yöntem yanıtının biçimini alır veya ayarlar.
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)
UseHttpGet	HTTP GET kullanarak yönteminin çağrılıp çağrılmayacağını belirten bir değer alır veya ayarlar.
XmlSerializeString	Tüm dönüş türlerinin dize türlerini içeren XML olarak serileştirilip serileştirilmediğini belirten bir değer alır veya ayarlar.

Yöntemler

Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür. (Devralındığı yer: Attribute)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını belirten bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Bir ad kümesini karşılık gelen bir dağıtma tanımlayıcısı kümesine eşler. (Devralındığı yer: Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Bir arabirimin tür bilgilerini almak için kullanılabilecek bir nesnenin tür bilgilerini alır. (Devralındığı yer: Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Bir nesnenin sağladığı tür bilgisi arabirimlerinin sayısını alır (0 ya da 1). (Devralındığı yer: Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bir nesne tarafından sunulan özelliklere ve yöntemlere erişim sağlar. (Devralındığı yer: Attribute)

Şunlara uygulanır