LoggerMessageAttribute 類別

定義

命名空間:

Microsoft.Extensions.Logging

組件:

Microsoft.Extensions.Logging.Abstractions.dll

套件:

Microsoft.Extensions.Logging.Abstractions v9.0.0-rc.2.24473.5

來源:

LoggerMessageAttribute.cs

提供資訊，以引導強型別記錄方法的生產。

C#

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

繼承

Object

Attribute

LoggerMessageAttribute

屬性

AttributeUsageAttribute

範例

C#

static partial class Log
{
    [LoggerMessage(EventId = 0, Message = "Could not open socket for {hostName}")]
    static partial void CouldNotOpenSocket(ILogger logger, LogLevel level, string hostName);
}

備註

這個屬性套用至下列方法：

- 必須是部分方法。

- 必須傳回 void。

- 不得為泛型。

- 必須有 ILogger 做為其其中一個參數。

- 必須有 LogLevel 做為其其中一個參數。

- 沒有任何參數可以是泛型。

建構函式

LoggerMessageAttribute()	初始化 LoggerMessageAttribute 類別的新實例，這個實例用來引導強型別記錄方法的生產。
LoggerMessageAttribute(Int32, LogLevel, String)	初始化 LoggerMessageAttribute 類別的新實例，這個實例用來引導強型別記錄方法的生產。
LoggerMessageAttribute(LogLevel, String)	初始化 LoggerMessageAttribute 類別的新實例，這個實例用來引導強型別記錄方法的生產。
LoggerMessageAttribute(LogLevel)	初始化 LoggerMessageAttribute 類別的新實例，這個實例用來引導強型別記錄方法的生產。
LoggerMessageAttribute(String)	初始化 LoggerMessageAttribute 類別的新實例，這個實例用來引導強型別記錄方法的生產。

屬性

EventId	取得記錄方法的記錄事件標識碼。
EventName	取得或設定記錄方法的記錄事件名稱。
Level	取得記錄方法的記錄層級。
Message	取得記錄方法的消息正文。
SkipEnabledCheck	取得旗標，以略過記錄方法的 IsEnabled 檢查。
TypeId	在衍生類別中實作時，取得這個 Attribute的唯一標識碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值表示這個實例是否等於指定的物件。 (繼承來源 Attribute)
GetHashCode()	傳回這個實例的哈希碼。 (繼承來源 Attribute)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，指出這個實例的值是否為衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，傳回值，指出這個實例是否等於指定的物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

適用於