Partilhar via


Método TextTransformation.Write (String, array<Object[])

Acrescenta uma cadeia de caracteres formatado, que contém zero ou mais especificações de formato, a saída gerada de texto. Cada especificação de formato é substituída pela representação de cadeia de caracteres de um argumento correspondente do objeto.

Namespace:  Microsoft.VisualStudio.TextTemplating
Assembly:  Microsoft.VisualStudio.TextTemplating.12.0 (em Microsoft.VisualStudio.TextTemplating.12.0.dll)

Sintaxe

'Declaração
Public Sub Write ( _
    format As String, _
    ParamArray args As Object() _
)
public void Write(
    string format,
    params Object[] args
)
public:
void Write(
    String^ format, 
    ... array<Object^>^ args
)
member Write : 
        format:string * 
        args:Object[] -> unit
public function Write(
    format : String, 
    ... args : Object[]
)

Parâmetros

  • format
    Tipo: String

    Uma cadeia de caracteres que contém zero ou mais especificações de formato.

  • args
    Tipo: array<Object[]

    Uma matriz de objetos em formato.

Exceções

Exceção Condição
ArgumentNullException

format é nulluma referência nula (Nothing no Visual Basic).

- ou -

args é nulluma referência nula (Nothing no Visual Basic).

FormatException

format é inválida.

ArgumentOutOfRangeException

Ampliar o valor de StringBuilder subjacente puder exceder MaxCapacity.

Comentários

O método de Write pode ser usado diretamente em um modelo de texto.

Exemplos

O exemplo de código a seguir demonstra chame o método de Write de um modelo de texto. Cole o código em qualquer arquivo de modelo de texto e executar a transformação do modelo de texto para ver os resultados.

<#
    string message = @"{0}: This is text to append number {1:F}.";

    Write(message, 0, 0);          //Using the Write method
    WriteLine(null);               //Using the WriteLine method
    WriteLine(null);               //Using the WriteLine method
    
    for(int j=1; j<4; j++)
    {
        WriteLine(message, j, j);  //Using the WriteLine method
    }
#>
<#
    Dim message as String = "{0}: This is text to append number {1:F}."
    Dim j as Integer = 0

    Write(message, 0, 0)          'Using the Write method
    WriteLine(Nothing)            'Using the WriteLine method
    WriteLine(Nothing)            'Using the WriteLine method
    
    For j = 1 To 3

        WriteLine(message, j, j)  'Using the WriteLine method
    Next
#>

Este exemplo gera a seguinte saída:

0: This is text to append number 0.00.

    

1: This is text to append number 1.00.

2: This is text to append number 2.00.

3: This is text to append number 3.00.

Segurança do .NET Framework

Consulte também

Referência

TextTransformation Classe

Sobrecargas Write

Namespace Microsoft.VisualStudio.TextTemplating

GenerationEnvironment

StringBuilder

AppendFormat

MaxCapacity

ArgumentOutOfRangeException

FormatException

ArgumentNullException

Outros recursos

Formatando tipos no .NET Framework

Numeric Format Strings

Date and Time Format Strings

Cadeias de caracteres de formato de enumeração

How to: Append to the Generated Text