DefaultParameterValueAttribute Sınıf

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.InteropServices.dll

Kaynak:

DefaultParameterValueAttribute.cs

Varsayılan parametreleri destekleyen bir dilden çağrıldığında parametrenin varsayılan değerini ayarlar. Bu sınıf devralınamaz.

public ref class DefaultParameterValueAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Parameter)]
public sealed class DefaultParameterValueAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Parameter)>]
type DefaultParameterValueAttribute = class
    inherit Attribute

Public NotInheritable Class DefaultParameterValueAttribute
Inherits Attribute

Devralma

Object

Attribute

DefaultParameterValueAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki kod örneği, özniteliğinin DefaultParameterValueAttribute C# dilinde yazılmış bir yöntemin parametresine nasıl uygulanacağını gösterir. Kod parçacığı, yöntemin OptionalAttribute bağımsız değişken olmadan çağrılmasını sağlamak için özniteliğini de kullanır.

using System;
using System.Runtime.InteropServices;

public class Program
{
    public static void MethodWithDefaultParam([Optional, DefaultParameterValue("DEFAULT_PARAM_VALUE")] string str)
    {
        Console.WriteLine($"The passed value is: {str}");
    }

    public static void Main()
    {
        MethodWithDefaultParam(); // The passed value is: DEFAULT_PARAM_VALUE
        MethodWithDefaultParam("NEW_VALUE"); // The passed value is: NEW_VALUE
    }    
}

C# isteğe bağlı bağımsız değişkenleri ile ile arasında DefaultParameterValueAttributeOptionalAttributebazı davranış farklılıkları vardır. Aşağıdaki kod parçacığı bu farkları gösterir.

using System.Runtime.InteropServices;

public class Program
{
    public static void MethodWithObjectDefaultAttr1([Optional, DefaultParameterValue(123)] object obj) {} // OK
    public static void MethodWithObjectDefaultAttr2([Optional, DefaultParameterValue("abc")] object obj) {} // OK
    public static void MethodWithObjectDefaultAttr3([Optional, DefaultParameterValue(null)] object? obj) {} // OK

    public static void MethodWithObjectDefaultParam1(object obj = 123) {} // CS1763
    public static void MethodWithObjectDefaultParam2(object obj = "abc") {} // CS1763
    public static void MethodWithObjectDefaultParam3(object obj? = null) {} // OK
}

Açıklamalar

özniteliği, DefaultParameterValueAttribute varsayılan parametreleri desteklemeyen bir dilde varsayılan parametre değeri belirtmenize olanak tanır. Bu özniteliği kodunuz için uyguladıktan sonra, varsayılan parametreleri destekleyen diller varsayılan parametre olarak belirtilen değeri kullanabilir.

DefaultParameterValueAttribute özellikle COM birlikte çalışma arabiriminin yöntemleri için varsayılan parametreleri belirtmek için kullanışlıdır.

Oluşturucular

Name	Description
DefaultParameterValueAttribute(Object)	Bir parametrenin DefaultParameterValueAttribute varsayılan değeriyle sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)
Value	Parametrenin varsayılan değerini alır.

Yöntemler

Name	Description
Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğin karma kodunu döndürür. (Devralındığı yer: Attribute)
GetType()	Geçerli örneğin Type 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ı gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)