DefaultParameterValueAttribute Sınıf

Tanım

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önteminin 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 OptionalAttributekullanma DefaultParameterValueAttribute arasında bazı 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 belirtilen değeri varsayılan parametre olarak kullanabilir.

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

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır