TaskLoggingHelper.ExtractMessageCode Method

2015-05-05

Extracts the message code prefix from the given full message string.

MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.

Namespace: Microsoft.Build.Utilities
Assembly: Microsoft.Build.Utilities.Core (in Microsoft.Build.Utilities.Core.dll)

Syntax

'Declaration
Public Function ExtractMessageCode ( _
    message As String, _
    <OutAttribute> ByRef messageWithoutCodePrefix As String _
) As String

public string ExtractMessageCode(
    string message,
    out string messageWithoutCodePrefix
)

public:
String^ ExtractMessageCode(
    String^ message, 
    [OutAttribute] String^% messageWithoutCodePrefix
)

member ExtractMessageCode : 
        message:string * 
        messageWithoutCodePrefix:string byref -> string

public function ExtractMessageCode(
    message : String, 
    messageWithoutCodePrefix : String
) : String

Parameters

message
Type: System.String

The full message to parse that includes code prefix.

messageWithoutCodePrefix
Type: System.String%

The message with the code prefix removed.

Return Value

Type: System.String
The message code prefix that is extracted from the full message string, or nulla null reference (Nothing in Visual Basic) if there is no message code.

Exceptions

Exception	Condition
ArgumentNullException	message is nulla null reference (Nothing in Visual Basic).

Remarks

Message code prefixes must match the following .NET regular expressions in order to be recognized: ^\s*[A-Za-z]+\d+:\s*.

Examples

If this method is given the full message string MYTASK1001: This is an error message. and it accepts This is an error message. as the value for the messageWithoutCodePrefix parameter, then it returns MYTASK1001.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see dd66cd4c-b087-415f-9c3e-94e3a1835f74.

通过