StringBuilder.AppendFormat Methode

Definitie

Naamruimte:: System.Text

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een bijbehorend objectargument.

Overloads

Name	Description
AppendFormat(String, Object, Object, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een van de drie argumenten.
AppendFormat(IFormatProvider, String, Object, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een van de twee argumenten met behulp van een opgegeven indelingsprovider.
AppendFormat(String, Object, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een van de twee argumenten.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een van de drie argumenten met behulp van een opgegeven indelingsprovider.
AppendFormat(IFormatProvider, String, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van één argument met behulp van een opgegeven indelingsprovider.
AppendFormat(String, Object[])	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een corresponderend argument in een parametermatrix.
AppendFormat(String, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van één argument.
AppendFormat(IFormatProvider, String, Object[])	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een corresponderend argument in een parametermatrix met behulp van een opgegeven indelingsprovider.

AppendFormat(String, Object, Object, Object)

public:
 System::Text::StringBuilder ^ AppendFormat(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public System.Text.StringBuilder AppendFormat(string format, object arg0, object arg1, object arg2);

member this.AppendFormat : string * obj * obj * obj -> System.Text.StringBuilder

Public Function AppendFormat (format As String, arg0 As Object, arg1 As Object, arg2 As Object) As StringBuilder

Parameters

format: String

Een tekenreeks met samengestelde notatie.

arg0: Object

Het eerste object dat moet worden opgemaakt.

arg1: Object

Het tweede object dat moet worden opgemaakt.

arg2: Object

Het derde object dat moet worden opgemaakt.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar waaraan format is toegevoegd. Elk opmaakitem format wordt vervangen door de tekenreeksweergave van het bijbehorende objectargument.

Uitzonderingen

ArgumentNullException

format is null.

FormatException

format is ongeldig.

– of –

De index van een opmaakitem is kleiner dan 0 (nul) of groter dan of gelijk aan 3.

ArgumentOutOfRangeException

De lengte van de uitgevouwen tekenreeks zou groter zijn dan MaxCapacity.

Voorbeelden

In het volgende voorbeeld ziet u de AppendFormat methode.

using System;
using System.Text;
using System.Globalization;

class Sample
{
    static StringBuilder sb = new StringBuilder();

    public static void Main()
    {
    int    var1   = 111;
    float  var2   = 2.22F;
    string var3   = "abcd";
    object[] var4 = {3, 4.4, 'X'};

    Console.WriteLine();
    Console.WriteLine("StringBuilder.AppendFormat method:");
    sb.AppendFormat("1) {0}", var1);
    Show(sb);
    sb.AppendFormat("2) {0}, {1}", var1, var2);
    Show(sb);
    sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3);
    Show(sb);
    sb.AppendFormat("4) {0}, {1}, {2}", var4);
    Show(sb);
    CultureInfo ci = new CultureInfo("es-ES", true);
    sb.AppendFormat(ci, "5) {0}", var2);
    Show(sb);
    }

    public static void Show(StringBuilder sbs)
    {
    Console.WriteLine(sbs.ToString());
    sb.Length = 0;
    }
}
/*
This example produces the following results:

StringBuilder.AppendFormat method:
1) 111
2) 111, 2.22
3) 111, 2.22, abcd
4) 3, 4.4, X
5) 2,22
*/

open System.Text
open System.Globalization

let sb = StringBuilder()

let show (sbs: StringBuilder) =
    printfn $"{sbs}"
    sb.Length <- 0

let var1 = 111
let var2 = 2.22f
let var3 = "abcd"
let var4: obj[] = [| 3; 4.4; 'X' |]

printfn "StringBuilder.AppendFormat method:"
sb.AppendFormat("1) {0}", var1) |> ignore
show sb
sb.AppendFormat("2) {0}, {1}", var1, var2) |> ignore
show sb
sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3) |> ignore
show sb
sb.AppendFormat("4) {0}, {1}, {2}", var4) |> ignore
show sb
let ci = CultureInfo("es-ES", true)
sb.AppendFormat(ci, "5) {0}", var2) |> ignore
show sb

// This example produces the following results:
//       StringBuilder.AppendFormat method:
//       1) 111
//       2) 111, 2.22
//       3) 111, 2.22, abcd
//       4) 3, 4.4, X
//       5) 2,22

Imports System.Text
Imports System.Globalization

Class Sample
   Private Shared sb As New StringBuilder()

   Public Shared Sub Main()
      Dim var1 As Integer = 111
      Dim var2 As Single = 2.22F
      Dim var3 As String = "abcd"
      Dim var4 As Object() =  {3, 4.4, "X"c}
      
      Console.WriteLine()
      Console.WriteLine("StringBuilder.AppendFormat method:")
      sb.AppendFormat("1) {0}", var1)
      Show(sb)
      sb.AppendFormat("2) {0}, {1}", var1, var2)
      Show(sb)
      sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3)
      Show(sb)
      sb.AppendFormat("4) {0}, {1}, {2}", var4)
      Show(sb)
      Dim ci As New CultureInfo("es-ES", True)
      sb.AppendFormat(ci, "5) {0}", var2)
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Console.WriteLine(sbs.ToString())
      sb.Length = 0
   End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.AppendFormat method:
'1) 111
'2) 111, 2.22
'3) 111, 2.22, abcd
'4) 3, 4.4, X
'5) 2,22

Opmerkingen

Deze methode maakt gebruik van de opmaakfunctie compositeopmaak van het .NET Framework om de waarde van een object te converteren naar de tekstweergave en die weergave in te sluiten in het huidige StringBuilder-object.

De format parameter bestaat uit nul of meer uitvoeringen van tekst die is gemengd met nul of meer geïndexeerde tijdelijke aanduidingen, genaamd notatie-items, die overeenkomen met arg0 door arg2, de objecten in de parameterlijst van deze methode. Het opmaakproces vervangt elk opmaakitem door de tekenreeksweergave van het bijbehorende object.

De syntaxis van een opmaakitem is als volgt:

{index[,length][:formatString]}

Elementen in vierkante haken zijn optioneel. In de volgende tabel wordt elk element beschreven.

Element	Description
index	De op nul gebaseerde positie in de parameterlijst van het object dat moet worden opgemaakt. Als het object dat door de index is `null`opgegeven, wordt het opmaakitem vervangen door String.Empty. Als er geen parameter in de indexpositie staat, wordt er een FormatException gegenereerd.
,lengte	Het minimale aantal tekens in de tekenreeksweergave van de parameter. Indien positief, wordt de parameter rechts uitgelijnd; als dit negatief is, wordt deze links uitgelijnd.
:formatString	Een standaard- of aangepaste notatietekenreeks die wordt ondersteund door de parameter.

Note

Zie Voor de standaard- en aangepaste notatietekenreeksen die worden gebruikt met datum- en tijdwaarden, tekenreeksen en aangepaste datum- en tijdnotatietekenreeksen. Zie Standaardtekenreeksen voor numerieke notatie en aangepaste notatietekenreeksen die worden gebruikt met numerieke waarden. Zie Opsommingstekenreeksen voor de standaardnotatietekenreeksen die worden gebruikt met opsommingen.

arg0, arg1en arg2 vertegenwoordigt de objecten die moeten worden opgemaakt. Elk opmaakitem format wordt vervangen door de tekenreeksweergave van ofwel arg0, arg1of arg2, afhankelijk van de index van het notatie-item. Als het opmaakitem en het bijbehorende object in args de IFormattable interface worden geïmplementeerdformatString, arg definieert x.ToString(formatString, null) de opmaak, waarbij x de index van het argument is. arg Anders definieert x.ToString() de opmaak.

Als de tekenreeks aan ons is toegewezen format , is 'Bedankt voor uw donatie van {0:####} blikjes voedsel aan onze liefdadigheidsorganisatie'. Dit arg0 is een geheel getal met de waarde 10, de retourwaarde is 'Bedankt voor uw donatie van 10 blikjes voedsel aan onze liefdadigheidsorganisatie'.

Notities voor bellers

Wanneer u in .NET Core en in de .NET Framework 4.0- en latere versies het StringBuilder-object instantiëren door de constructor StringBuilder(Int32, Int32) aan te roepen, kan zowel de lengte als de capaciteit van het StringBuilder-exemplaar groter worden dan de waarde van de eigenschap MaxCapacity. Dit kan met name gebeuren wanneer u de Append(String) en AppendFormat(String, Object) methoden aanroept om kleine tekenreeksen toe te voegen.

Zie ook

Van toepassing op

AppendFormat(IFormatProvider, String, Object, Object)

public:
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public System.Text.StringBuilder AppendFormat(IFormatProvider provider, string format, object arg0, object arg1);

member this.AppendFormat : IFormatProvider * string * obj * obj -> System.Text.StringBuilder

Public Function AppendFormat (provider As IFormatProvider, format As String, arg0 As Object, arg1 As Object) As StringBuilder

Parameters

provider: IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie levert.

format: String

Een tekenreeks met samengestelde notatie.

arg0: Object

Het eerste object dat moet worden opgemaakt.

arg1: Object

Het tweede object dat moet worden opgemaakt.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de toevoegbewerking is voltooid. Na de toevoegbewerking bevat dit exemplaar alle gegevens die vóór de bewerking bestonden, achtervoegsel door een kopie van format waar een indelingsspecificatie wordt vervangen door de tekenreeksweergave van het bijbehorende objectargument.

Uitzonderingen

ArgumentNullException

format is null.

FormatException

format is ongeldig.

– of –

De index van een opmaakitem is kleiner dan 0 (nul) of groter dan of gelijk aan 2 (twee).

ArgumentOutOfRangeException

De lengte van de uitgevouwen tekenreeks zou groter zijn dan MaxCapacity.

Voorbeelden

In het volgende voorbeeld wordt de AppendFormat(IFormatProvider, String, Object, Object) methode gebruikt om tijd- en temperatuurgegevens weer te geven die zijn opgeslagen in een algemeen Dictionary<TKey,TValue> object. Houd er rekening mee dat de notatietekenreeks drie opmaakitems heeft, hoewel er alleen objecten zijn om op te maken. Dit komt doordat het eerste object in de lijst (een datum- en tijdwaarde) wordt gebruikt door twee notatie-items: het eerste opmaakitem geeft de tijd weer en de tweede geeft de datum weer.

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Text;

public class Example
{
   public static void Main()
   {
      CultureInfo culture = new CultureInfo("en-US");
      StringBuilder sb = new StringBuilder();
      Dictionary<DateTime, Double> temperatureInfo = new Dictionary<DateTime, Double>(); 
      temperatureInfo.Add(new DateTime(2010, 6, 1, 14, 0, 0), 87.46);
      temperatureInfo.Add(new DateTime(2010, 12, 1, 10, 0, 0), 36.81);

      sb.AppendLine("Temperature Information:\n");
      foreach (var item in temperatureInfo)
      {
         sb.AppendFormat(culture,
                         "Temperature at {0,8:t} on {0,9:d}: {1,5:N1}°F\n",
                         item.Key, item.Value);
      }
      Console.WriteLine(sb.ToString());
   }
}
// The example displays the following output:
//       Temperature Information:
//       
//       Temperature at  2:00 PM on  6/1/2010:  87.5°F
//       Temperature at 10:00 AM on 12/1/2010:  36.8°F

open System
open System.Collections.Generic
open System.Globalization
open System.Text

let culture = CultureInfo "en-US"
let sb = StringBuilder()
let temperatureInfo = Dictionary<DateTime, Double>()
temperatureInfo.Add(DateTime(2010, 6, 1, 14, 0, 0), 87.46)
temperatureInfo.Add(DateTime(2010, 12, 1, 10, 0, 0), 36.81)

sb.AppendLine "Temperature Information:\n" |> ignore

for item in temperatureInfo do
    sb.AppendFormat(culture, "Temperature at {0,8:t} on {0,9:d}: {1,5:N1}°F\n", item.Key, item.Value)
    |> ignore

printfn $"{sb}"

// The example displays the following output:
//       Temperature Information:
//
//       Temperature at  2:00 PM on  6/1/2010:  87.5°F
//       Temperature at 10:00 AM on 12/1/2010:  36.8°F

Imports System.Collections.Generic
Imports System.Globalization
Imports System.Text

Module Example
   Public Sub Main()
      Dim culture As New CultureInfo("en-US")
      Dim sb As New StringBuilder()
      Dim temperatureInfo As New Dictionary(Of Date, Double) 
      temperatureInfo.Add(#6/1/2010 2:00PM#, 87.46)
      temperatureInfo.Add(#12/1/2010 10:00AM#, 36.81)
      
      sb.AppendLine("Temperature Information:").AppendLine()
      For Each item In temperatureInfo
         sb.AppendFormat(culture,
                         "Temperature at {0,8:t} on {0,9:d}: {1,5:N1}°F",
                         item.Key, item.Value).AppendLine()
      Next
      Console.WriteLine(sb.ToString())
   End Sub
End Module
' The example displays the following output:
'       Temperature Information:
'       
'       Temperature at  2:00 PM on  6/1/2010:  87.5°F
'       Temperature at 10:00 AM on 12/1/2010:  36.8°F

Opmerkingen

De format parameter bestaat uit nul of meer uitvoeringen van tekst die is gemengd met nul of meer geïndexeerde tijdelijke aanduidingen, genaamd notatie-items, die overeenkomen met objecten in de parameterlijst van deze methode. Het opmaakproces vervangt elk opmaakitem door de tekenreeksweergave van het bijbehorende object.

De syntaxis van een opmaakitem is als volgt:

{index[,length][:formatString]}

Elementen in vierkante haken zijn optioneel. In de volgende tabel wordt elk element beschreven.

Element	Description
index	De op nul gebaseerde positie in de parameterlijst van het object dat moet worden opgemaakt. Als het object dat door de index is `null`opgegeven, wordt het opmaakitem vervangen door String.Empty. Als er geen parameter in de indexpositie staat, wordt er een FormatException gegenereerd.
,lengte	Het minimale aantal tekens in de tekenreeksweergave van de parameter. Indien positief, wordt de parameter rechts uitgelijnd; als dit negatief is, wordt deze links uitgelijnd.
:formatString	Een standaard- of aangepaste notatietekenreeks die wordt ondersteund door de parameter.

Note

De provider parameter geeft een IFormatProvider implementatie op die opmaakinformatie arg0 voor en arg1. provider kan een van de volgende zijn:

Een CultureInfo object dat cultuurspecifieke opmaakinformatie biedt.
Een NumberFormatInfo object dat cultuurspecifieke opmaakinformatie biedt voor arg0 of arg1 als het numerieke waarden zijn.
Een DateTimeFormatInfo object dat cultuurspecifieke opmaakinformatie biedt voor arg0 of arg1 als het datum- en tijdwaarden zijn.
Een aangepaste IFormatProvider implementatie die opmaakinformatie biedt voor arg0 en arg1. Normaal gesproken implementeert een dergelijke implementatie ook de ICustomFormatter interface.

Als de provider parameter is null, wordt de providergegevens van de indeling verkregen uit de huidige cultuur.

arg0 en arg1 vertegenwoordigt de objecten die moeten worden opgemaakt. Elk opmaakitem wordt format vervangen door de tekenreeksweergave van het object met de bijbehorende index. Als het opmaakitem de interface bevat formatString en het bijbehorende argument implementeert IFormattable , definieert de methode van ToString(formatString, provider) het argument de opmaak. Anders definieert de methode van ToString() het argument de opmaak.

Notities voor bellers

IIn .NET Core en in de .NET Framework 4.0- en latere versies, wanneer u het StringBuilder-object instantiëren door de StringBuilder(Int32, Int32) constructor aan te roepen, kan zowel de lengte als de capaciteit van het StringBuilder-exemplaar groter worden dan de waarde van de eigenschap MaxCapacity. Dit kan met name gebeuren wanneer u de Append(String) en AppendFormat(String, Object) methoden aanroept om kleine tekenreeksen toe te voegen.

Zie ook

Van toepassing op

AppendFormat(String, Object, Object)

public:
 System::Text::StringBuilder ^ AppendFormat(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public System.Text.StringBuilder AppendFormat(string format, object arg0, object arg1);

member this.AppendFormat : string * obj * obj -> System.Text.StringBuilder

Public Function AppendFormat (format As String, arg0 As Object, arg1 As Object) As StringBuilder

Parameters

format: String

Een tekenreeks met samengestelde notatie.

arg0: Object

Het eerste object dat moet worden opgemaakt.

arg1: Object

Het tweede object dat moet worden opgemaakt.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar waaraan format is toegevoegd. Elk opmaakitem format wordt vervangen door de tekenreeksweergave van het bijbehorende objectargument.

Uitzonderingen

ArgumentNullException

format is null.

FormatException

format is ongeldig.

– of –

De index van een opmaakitem is kleiner dan 0 (nul) of groter dan of gelijk aan 2.

ArgumentOutOfRangeException

De lengte van de uitgevouwen tekenreeks zou groter zijn dan MaxCapacity.

Voorbeelden

In het volgende voorbeeld ziet u de AppendFormat methode.

using System;
using System.Text;
using System.Globalization;

class Sample
{
    static StringBuilder sb = new StringBuilder();

    public static void Main()
    {
    int    var1   = 111;
    float  var2   = 2.22F;
    string var3   = "abcd";
    object[] var4 = {3, 4.4, 'X'};

    Console.WriteLine();
    Console.WriteLine("StringBuilder.AppendFormat method:");
    sb.AppendFormat("1) {0}", var1);
    Show(sb);
    sb.AppendFormat("2) {0}, {1}", var1, var2);
    Show(sb);
    sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3);
    Show(sb);
    sb.AppendFormat("4) {0}, {1}, {2}", var4);
    Show(sb);
    CultureInfo ci = new CultureInfo("es-ES", true);
    sb.AppendFormat(ci, "5) {0}", var2);
    Show(sb);
    }

    public static void Show(StringBuilder sbs)
    {
    Console.WriteLine(sbs.ToString());
    sb.Length = 0;
    }
}
/*
This example produces the following results:

StringBuilder.AppendFormat method:
1) 111
2) 111, 2.22
3) 111, 2.22, abcd
4) 3, 4.4, X
5) 2,22
*/

open System.Text
open System.Globalization

let sb = StringBuilder()

let show (sbs: StringBuilder) =
    printfn $"{sbs}"
    sb.Length <- 0

let var1 = 111
let var2 = 2.22f
let var3 = "abcd"
let var4: obj[] = [| 3; 4.4; 'X' |]

printfn "StringBuilder.AppendFormat method:"
sb.AppendFormat("1) {0}", var1) |> ignore
show sb
sb.AppendFormat("2) {0}, {1}", var1, var2) |> ignore
show sb
sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3) |> ignore
show sb
sb.AppendFormat("4) {0}, {1}, {2}", var4) |> ignore
show sb
let ci = CultureInfo("es-ES", true)
sb.AppendFormat(ci, "5) {0}", var2) |> ignore
show sb

// This example produces the following results:
//       StringBuilder.AppendFormat method:
//       1) 111
//       2) 111, 2.22
//       3) 111, 2.22, abcd
//       4) 3, 4.4, X
//       5) 2,22

Imports System.Text
Imports System.Globalization

Class Sample
   Private Shared sb As New StringBuilder()

   Public Shared Sub Main()
      Dim var1 As Integer = 111
      Dim var2 As Single = 2.22F
      Dim var3 As String = "abcd"
      Dim var4 As Object() =  {3, 4.4, "X"c}
      
      Console.WriteLine()
      Console.WriteLine("StringBuilder.AppendFormat method:")
      sb.AppendFormat("1) {0}", var1)
      Show(sb)
      sb.AppendFormat("2) {0}, {1}", var1, var2)
      Show(sb)
      sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3)
      Show(sb)
      sb.AppendFormat("4) {0}, {1}, {2}", var4)
      Show(sb)
      Dim ci As New CultureInfo("es-ES", True)
      sb.AppendFormat(ci, "5) {0}", var2)
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Console.WriteLine(sbs.ToString())
      sb.Length = 0
   End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.AppendFormat method:
'1) 111
'2) 111, 2.22
'3) 111, 2.22, abcd
'4) 3, 4.4, X
'5) 2,22

Opmerkingen

De format parameter bestaat uit nul of meer uitvoeringen van tekst die is gemengd met nul of meer geïndexeerde tijdelijke aanduidingen, genaamd notatie-items, die overeenkomen met arg0 en arg1, de twee objecten in de parameterlijst van deze methode. Het opmaakproces vervangt elk opmaakitem door de tekenreeksweergave van het bijbehorende object.

De syntaxis van een opmaakitem is als volgt:

{index[,length][:formatString]}

Elementen in vierkante haken zijn optioneel. In de volgende tabel wordt elk element beschreven.

Element	Description
index	De op nul gebaseerde positie in de parameterlijst van het object dat moet worden opgemaakt. Als het object dat door de index is `null`opgegeven, wordt het opmaakitem vervangen door String.Empty. Als er geen parameter in de indexpositie staat, wordt er een FormatException gegenereerd.
,lengte	Het minimale aantal tekens in de tekenreeksweergave van de parameter. Indien positief, wordt de parameter rechts uitgelijnd; als dit negatief is, wordt deze links uitgelijnd.
:formatString	Een standaard- of aangepaste notatietekenreeks die wordt ondersteund door de parameter.

Note

arg0 en arg1 vertegenwoordigt de objecten die moeten worden opgemaakt. Elk opmaakitem format wordt vervangen door de tekenreeksweergave van of arg0arg1. Als het opmaakitem de interface bevat formatString en het bijbehorende object implementeertIFormattable, arg definieert x.ToString(formatString, provider) de opmaak, waarbij x de index van het argument is. arg Anders definieert x.ToString() de opmaak.

Notities voor bellers

Zie ook

Van toepassing op

AppendFormat(IFormatProvider, String, Object, Object, Object)

public:
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public System.Text.StringBuilder AppendFormat(IFormatProvider provider, string format, object arg0, object arg1, object arg2);

member this.AppendFormat : IFormatProvider * string * obj * obj * obj -> System.Text.StringBuilder

Public Function AppendFormat (provider As IFormatProvider, format As String, arg0 As Object, arg1 As Object, arg2 As Object) As StringBuilder

Parameters

provider: IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie levert.

format: String

Een tekenreeks met samengestelde notatie.

arg0: Object

Het eerste object dat moet worden opgemaakt.

arg1: Object

Het tweede object dat moet worden opgemaakt.

arg2: Object

Het derde object dat moet worden opgemaakt.

Retouren

StringBuilder

Uitzonderingen

ArgumentNullException

format is null.

FormatException

format is ongeldig.

– of –

De index van een opmaakitem is kleiner dan 0 (nul) of groter dan of gelijk aan 3 (drie).

ArgumentOutOfRangeException

De lengte van de uitgevouwen tekenreeks zou groter zijn dan MaxCapacity.

Voorbeelden

In het volgende voorbeeld wordt de AppendFormat(IFormatProvider, String, Object, Object, Object) methode gebruikt om het resultaat van een Booleaanse And bewerking met gehele getallen weer te geven. Houd er rekening mee dat de notatietekenreeks zes opmaakitems bevat, maar de methode slechts drie items in de argumentenlijst bevat, omdat elk item op twee verschillende manieren is opgemaakt.

using System;
using System.Globalization;
using System.Text;

public class Example
{
   public static void Main()
   {
      Random rnd = new Random();
      CultureInfo culture = CultureInfo.CreateSpecificCulture("fr-FR");
      StringBuilder sb = new StringBuilder();
      string formatString = "    {0,12:N0} ({0,8:X8})\n" +
                            "And {1,12:N0} ({1,8:X8})\n" +
                            "  = {2,12:N0} ({2,8:X8})\n";
      for (int ctr = 0; ctr <= 2; ctr++) {
         int value1 = rnd.Next();
         int value2 = rnd.Next();
         sb.AppendFormat(culture, formatString,
                         value1, value2, value1 & value2).
                         AppendLine();
      }
      Console.WriteLine(sb.ToString());
   }
}
// The example displays output like the following:
//           1 984 112 195 (76432643)
//       And 1 179 778 511 (4651FDCF)
//         = 1 178 674 243 (46412443)
//
//           2 034 813 710 (7948CB0E)
//       And  569 333 976 (21EF58D8)
//         =  558 385 160 (21484808)
//
//            126 717 735 (078D8F27)
//       And 1 830 715 973 (6D1E8245)
//         =   84 705 797 (050C8205)

open System
open System.Globalization
open System.Text

let rnd = Random()
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
let sb = StringBuilder()

let formatString =
    "    {0,12:N0} ({0,8:X8})\nAnd {1,12:N0} ({1,8:X8})\n  = {2,12:N0} ({2,8:X8})\n"

for _ = 0 to 2 do
    let value1 = rnd.Next()
    let value2 = rnd.Next()

    sb
        .AppendFormat(culture, formatString, value1, value2, value1 &&& value2)
        .AppendLine()
    |> ignore

printfn $"{sb}"

// The example displays output like the following:
//           1 984 112 195 (76432643)
//       And 1 179 778 511 (4651FDCF)
//         = 1 178 674 243 (46412443)
//
//           2 034 813 710 (7948CB0E)
//       And  569 333 976 (21EF58D8)
//         =  558 385 160 (21484808)
//
//            126 717 735 (078D8F27)
//       And 1 830 715 973 (6D1E8245)
//         =   84 705 797 (050C8205)

Imports System.Globalization
Imports System.Text

Public Module Example
   Public Sub Main()
      Dim rnd As New Random()
      Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture("fr-FR")
      Dim sb As New StringBuilder()
      Dim formatString As String = "    {0,12:N0} ({0,8:X8})" + vbCrLf +
                                   "And {1,12:N0} ({1,8:X8})" + vbCrLf +
                                   "  = {2,12:N0} ({2,8:X8})" + vbCrLf
      For ctr As Integer = 0 To 2
         Dim value1 As Integer = rnd.Next()
         Dim value2 As Integer = rnd.Next()
         sb.AppendFormat(culture, formatString,
                         value1, value2, value1 And value2).AppendLine()
      Next
      Console.WriteLine(sb.ToString())
   End Sub
End Module
' The example displays the following output:
'           1 984 112 195 (76432643)
'       And 1 179 778 511 (4651FDCF)
'         = 1 178 674 243 (46412443)
'
'           2 034 813 710 (7948CB0E)
'       And  569 333 976 (21EF58D8)
'         =  558 385 160 (21484808)
'
'            126 717 735 (078D8F27)
'       And 1 830 715 973 (6D1E8245)
'         =   84 705 797 (050C8205)

Opmerkingen

De format parameter bestaat uit nul of meer uitvoeringen van tekst die is gemengd met nul of meer geïndexeerde tijdelijke aanduidingen, genaamd notatie-items, die overeenkomen met objecten in de parameterlijst van deze methode. Het opmaakproces vervangt elk opmaakitem door de tekenreeksweergave van het bijbehorende object.

De syntaxis van een opmaakitem is als volgt:

{index[,length][:formatString]}

Elementen in vierkante haken zijn optioneel. In de volgende tabel wordt elk element beschreven.

Element	Description
index	De op nul gebaseerde positie in de parameterlijst van het object dat moet worden opgemaakt. Als het object dat door de index is `null`opgegeven, wordt het opmaakitem vervangen door String.Empty. Als er geen parameter in de indexpositie staat, wordt er een FormatException gegenereerd.
,lengte	Het minimale aantal tekens in de tekenreeksweergave van de parameter. Indien positief, wordt de parameter rechts uitgelijnd; als dit negatief is, wordt deze links uitgelijnd.
:formatString	Een standaard- of aangepaste notatietekenreeks die wordt ondersteund door de parameter.

Note

De provider parameter geeft een IFormatProvider implementatie op die opmaakinformatie arg0 voor en arg1. provider kan een van de volgende zijn:

Een CultureInfo object dat cultuurspecifieke opmaakinformatie biedt.
Een NumberFormatInfo object dat cultuurspecifieke opmaakinformatie biedt voor arg0 of arg1 als het numerieke waarden zijn.
Een DateTimeFormatInfo object dat cultuurspecifieke opmaakinformatie biedt voor arg0, arg1of arg2 als het datum- en tijdwaarden zijn.
Een aangepaste IFormatProvider implementatie die opmaakinformatie biedt voor arg0, arg1en arg2. Normaal gesproken implementeert een dergelijke implementatie ook de ICustomFormatter interface.

Als de provider parameter is null, wordt de providergegevens van de indeling verkregen uit de huidige cultuur.

arg0, arg1en arg2 vertegenwoordigt de objecten die moeten worden opgemaakt. Elk opmaakitem wordt format vervangen door de tekenreeksweergave van het object met de bijbehorende index. Als het opmaakitem de interface bevat formatString en het bijbehorende argument implementeert IFormattable , definieert de methode van ToString(formatString, provider) het argument de opmaak. Anders definieert de methode van ToString() het argument de opmaak.

Notities voor bellers

Zie ook

Van toepassing op

AppendFormat(IFormatProvider, String, Object)

public:
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::String ^ format, System::Object ^ arg0);

public System.Text.StringBuilder AppendFormat(IFormatProvider provider, string format, object arg0);

member this.AppendFormat : IFormatProvider * string * obj -> System.Text.StringBuilder

Public Function AppendFormat (provider As IFormatProvider, format As String, arg0 As Object) As StringBuilder

Parameters

provider: IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie levert.

format: String

Een tekenreeks met samengestelde notatie.

arg0: Object

Het object dat moet worden opgemaakt.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de toevoegbewerking is voltooid. Na de toevoegbewerking bevat dit exemplaar alle gegevens die vóór de bewerking bestonden, achtervoegsel door een kopie waarvan format elke indelingsspecificatie wordt vervangen door de tekenreeksweergave van arg0.

Uitzonderingen

ArgumentNullException

format is null.

FormatException

format is ongeldig.

– of –

De index van een opmaakitem is kleiner dan 0 (nul) of groter dan of gelijk aan één (1).

ArgumentOutOfRangeException

De lengte van de uitgevouwen tekenreeks zou groter zijn dan MaxCapacity.

Voorbeelden

Hieronder vindt u twee aanroepen naar de AppendFormat(IFormatProvider, String, Object) methode. Beide gebruiken de opmaakconventies van de English-United Koninkrijk (en-GB) cultuur. De eerste voegt de tekenreeksweergave van een Decimal waardevaluta in een resultaattekenreeks in. De tweede voegt een DateTime waarde in op twee plaatsen in een resultaattekenreeks, de eerste met alleen de korte datumtekenreeks en de tweede de korte tijdtekenreeks.

using System;
using System.Globalization;
using System.Text;

public class Example
{
   public static void Main()
   {
      StringBuilder sb = new StringBuilder();
      Decimal value = 16.95m;
      CultureInfo enGB = CultureInfo.CreateSpecificCulture("en-GB");
      DateTime dateToday = DateTime.Now;
      sb.AppendFormat(enGB, "Final Price: {0:C2}", value);
      sb.AppendLine();
      sb.AppendFormat(enGB, "Date and Time: {0:d} at {0:t}", dateToday);
      Console.WriteLine(sb.ToString());
   }
}
// The example displays the following output:
//       Final Price: £16.95
//       Date and Time: 01/10/2014 at 10:22

open System
open System.Globalization
open System.Text

let sb = StringBuilder()
let value = 16.95m
let enGB = CultureInfo.CreateSpecificCulture "en-GB"
let dateToday = DateTime.Now
sb.AppendFormat(enGB, "Final Price: {0:C2}", value) |> ignore
sb.AppendLine() |> ignore
sb.AppendFormat(enGB, "Date and Time: {0:d} at {0:t}", dateToday) |> ignore
printfn $"{sb}"

// The example displays the following output:
//       Final Price: £16.95
//       Date and Time: 01/10/2014 at 10:22

Imports System.Globalization
Imports System.Text

Module Example
   Public Sub Main()
      Dim sb As New StringBuilder()
      Dim value As Decimal = 16.95d
      Dim enGB As CultureInfo = CultureInfo.CreateSpecificCulture("en-GB")
      Dim dateToday As DateTime = Date.Now
      sb.AppendFormat(enGB, "Final Price: {0:C2}", value)
      sb.AppendLine()
      sb.AppendFormat(enGB, "Date and Time: {0:d} at {0:t}", dateToday)
      Console.WriteLine(sb.ToString())
   End Sub
End Module
' The example displays output like the following:
'       Final Price: £16.95
'       Date and Time: 01/10/2014 at 10:22

Opmerkingen

Deze methode maakt gebruik van de opmaakfunctie composite van het .NET Framework om de waarde van arg0 te converteren naar de tekstweergave en die weergave in te sluiten in het huidige StringBuilder-object.

De format parameter bestaat uit nul of meer uitvoeringen van tekst die is gemengd met nul of meer geïndexeerde tijdelijke aanduidingen, genaamd opmaakitems. De index van elk notatie-item moet nul (0) zijn, omdat deze methode een argumentenlijst met één argument bevat. Het opmaakproces vervangt elk opmaakitem door de tekenreeksweergave van arg0.

De syntaxis van een opmaakitem is als volgt:

{index[,length][:formatString]}

Elementen in vierkante haken zijn optioneel. In de volgende tabel wordt elk element beschreven.

Element	Description
index	De op nul gebaseerde positie in de parameterlijst van het object dat moet worden opgemaakt. Als het object dat door de index is `null`opgegeven, wordt het opmaakitem vervangen door String.Empty. Aangezien de AppendFormat(IFormatProvider, String, Object) methode in dit geval één argument in de argumentenlijst heeft, moet de waarde van de index altijd 0 zijn. Als dat niet zo is, wordt er een FormatException gegooid.
,lengte	Het minimale aantal tekens in de tekenreeksweergave van de parameter. Indien positief, wordt de parameter rechts uitgelijnd; als dit negatief is, wordt deze links uitgelijnd.
:formatString	Een standaard- of aangepaste notatietekenreeks die wordt ondersteund door de parameter.

Note

Met provider de parameter geeft u een IFormatProvider implementatie op die opmaakinformatie kan bieden voor de objecten in args. provider kan een van de volgende zijn:

Een CultureInfo object dat cultuurspecifieke opmaakinformatie biedt.
Een NumberFormatInfo object dat cultuurspecifieke opmaakinformatie arg0 biedt als het een numerieke waarde is.
Een DateTimeFormatInfo object dat cultuurspecifieke opmaakinformatie arg0 biedt als het een datum- en tijdwaarde is.
Een aangepaste IFormatProvider implementatie die opmaakinformatie biedt voor arg0. Normaal gesproken implementeert een dergelijke implementatie ook de ICustomFormatter interface.

Als de provider parameter is null, wordt opmaakinformatie verkregen uit de huidige cultuur.

arg0 vertegenwoordigt het object dat moet worden opgemaakt. Elk opmaakitem wordt format vervangen door de tekenreeksweergave van arg0. Als het opmaakitem de IFormattable interface bevat formatString en arg0 implementeert, arg0.ToString(formatString, provider) definieert u de opmaak. arg0.ToString() Anders definieert u de opmaak.

Notities voor bellers

Zie ook

Van toepassing op

AppendFormat(String, Object[])

public:
 System::Text::StringBuilder ^ AppendFormat(System::String ^ format, ... cli::array <System::Object ^> ^ args);

public System.Text.StringBuilder AppendFormat(string format, params object[] args);

member this.AppendFormat : string * obj[] -> System.Text.StringBuilder

Public Function AppendFormat (format As String, ParamArray args As Object()) As StringBuilder

Parameters

format: String

Een tekenreeks met samengestelde notatie.

args: Object[]

Een matrix met objecten die moeten worden opgemaakt.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar waaraan format is toegevoegd. Elk opmaakitem format wordt vervangen door de tekenreeksweergave van het bijbehorende objectargument.

Uitzonderingen

ArgumentNullException

format of args is null.

FormatException

format is ongeldig.

– of –

De index van een opmaakitem is kleiner dan 0 (nul) of groter dan of gelijk aan de lengte van de args matrix.

ArgumentOutOfRangeException

De lengte van de uitgevouwen tekenreeks zou groter zijn dan MaxCapacity.

Voorbeelden

In het volgende voorbeeld ziet u de AppendFormat methode.

using System;
using System.Text;
using System.Globalization;

class Sample
{
    static StringBuilder sb = new StringBuilder();

    public static void Main()
    {
    int    var1   = 111;
    float  var2   = 2.22F;
    string var3   = "abcd";
    object[] var4 = {3, 4.4, 'X'};

    Console.WriteLine();
    Console.WriteLine("StringBuilder.AppendFormat method:");
    sb.AppendFormat("1) {0}", var1);
    Show(sb);
    sb.AppendFormat("2) {0}, {1}", var1, var2);
    Show(sb);
    sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3);
    Show(sb);
    sb.AppendFormat("4) {0}, {1}, {2}", var4);
    Show(sb);
    CultureInfo ci = new CultureInfo("es-ES", true);
    sb.AppendFormat(ci, "5) {0}", var2);
    Show(sb);
    }

    public static void Show(StringBuilder sbs)
    {
    Console.WriteLine(sbs.ToString());
    sb.Length = 0;
    }
}
/*
This example produces the following results:

StringBuilder.AppendFormat method:
1) 111
2) 111, 2.22
3) 111, 2.22, abcd
4) 3, 4.4, X
5) 2,22
*/

open System.Text
open System.Globalization

let sb = StringBuilder()

let show (sbs: StringBuilder) =
    printfn $"{sbs}"
    sb.Length <- 0

let var1 = 111
let var2 = 2.22f
let var3 = "abcd"
let var4: obj[] = [| 3; 4.4; 'X' |]

printfn "StringBuilder.AppendFormat method:"
sb.AppendFormat("1) {0}", var1) |> ignore
show sb
sb.AppendFormat("2) {0}, {1}", var1, var2) |> ignore
show sb
sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3) |> ignore
show sb
sb.AppendFormat("4) {0}, {1}, {2}", var4) |> ignore
show sb
let ci = CultureInfo("es-ES", true)
sb.AppendFormat(ci, "5) {0}", var2) |> ignore
show sb

// This example produces the following results:
//       StringBuilder.AppendFormat method:
//       1) 111
//       2) 111, 2.22
//       3) 111, 2.22, abcd
//       4) 3, 4.4, X
//       5) 2,22

Imports System.Text
Imports System.Globalization

Class Sample
   Private Shared sb As New StringBuilder()

   Public Shared Sub Main()
      Dim var1 As Integer = 111
      Dim var2 As Single = 2.22F
      Dim var3 As String = "abcd"
      Dim var4 As Object() =  {3, 4.4, "X"c}
      
      Console.WriteLine()
      Console.WriteLine("StringBuilder.AppendFormat method:")
      sb.AppendFormat("1) {0}", var1)
      Show(sb)
      sb.AppendFormat("2) {0}, {1}", var1, var2)
      Show(sb)
      sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3)
      Show(sb)
      sb.AppendFormat("4) {0}, {1}, {2}", var4)
      Show(sb)
      Dim ci As New CultureInfo("es-ES", True)
      sb.AppendFormat(ci, "5) {0}", var2)
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Console.WriteLine(sbs.ToString())
      sb.Length = 0
   End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.AppendFormat method:
'1) 111
'2) 111, 2.22
'3) 111, 2.22, abcd
'4) 3, 4.4, X
'5) 2,22

Opmerkingen

De format parameter bestaat uit nul of meer uitvoeringen van tekst die is gemengd met nul of meer geïndexeerde tijdelijke aanduidingen, genaamd notatie-items, die overeenkomen met objecten in de parameterlijst van deze methode. Het opmaakproces vervangt elk opmaakitem door de tekenreeksweergave van het bijbehorende object.

De syntaxis van een opmaakitem is als volgt:

{index[,length][:formatString]}

Elementen in vierkante haken zijn optioneel. In de volgende tabel wordt elk element beschreven.

Element	Description
index	De op nul gebaseerde positie in de parameterlijst van het object dat moet worden opgemaakt. Als het object dat door de index is `null`opgegeven, wordt het opmaakitem vervangen door String.Empty. Als er geen parameter in de indexpositie staat, wordt er een FormatException gegenereerd.
,lengte	Het minimale aantal tekens in de tekenreeksweergave van de parameter. Indien positief, wordt de parameter rechts uitgelijnd; als dit negatief is, wordt deze links uitgelijnd.
:formatString	Een standaard- of aangepaste notatietekenreeks die wordt ondersteund door de parameter.

Note

args vertegenwoordigt de objecten die moeten worden opgemaakt. Elk opmaakitem wordt format vervangen door de tekenreeksweergave van het bijbehorende object in args. Als het opmaakitem en het bijbehorende object in args de IFormattable interface worden geïmplementeerdformatString, args[index].ToString(formatString, provider) definieert u de opmaak. args[index].ToString() Anders definieert u de opmaak.

Notities voor bellers

Zie ook

Van toepassing op

AppendFormat(String, Object)

public:
 System::Text::StringBuilder ^ AppendFormat(System::String ^ format, System::Object ^ arg0);

public System.Text.StringBuilder AppendFormat(string format, object arg0);

member this.AppendFormat : string * obj -> System.Text.StringBuilder

Public Function AppendFormat (format As String, arg0 As Object) As StringBuilder

Parameters

format: String

Een tekenreeks met samengestelde notatie.

arg0: Object

Een object dat moet worden opgemaakt.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar waaraan format is toegevoegd. Elk opmaakitem format wordt vervangen door de tekenreeksweergave van arg0.

Uitzonderingen

ArgumentNullException

format is null.

FormatException

format is ongeldig.

– of –

De index van een opmaakitem is kleiner dan 0 (nul) of groter dan of gelijk aan 1.

ArgumentOutOfRangeException

De lengte van de uitgevouwen tekenreeks zou groter zijn dan MaxCapacity.

Voorbeelden

In het volgende voorbeeld ziet u de AppendFormat methode.

using System;
using System.Text;
using System.Globalization;

class Sample
{
    static StringBuilder sb = new StringBuilder();

    public static void Main()
    {
    int    var1   = 111;
    float  var2   = 2.22F;
    string var3   = "abcd";
    object[] var4 = {3, 4.4, 'X'};

    Console.WriteLine();
    Console.WriteLine("StringBuilder.AppendFormat method:");
    sb.AppendFormat("1) {0}", var1);
    Show(sb);
    sb.AppendFormat("2) {0}, {1}", var1, var2);
    Show(sb);
    sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3);
    Show(sb);
    sb.AppendFormat("4) {0}, {1}, {2}", var4);
    Show(sb);
    CultureInfo ci = new CultureInfo("es-ES", true);
    sb.AppendFormat(ci, "5) {0}", var2);
    Show(sb);
    }

    public static void Show(StringBuilder sbs)
    {
    Console.WriteLine(sbs.ToString());
    sb.Length = 0;
    }
}
/*
This example produces the following results:

StringBuilder.AppendFormat method:
1) 111
2) 111, 2.22
3) 111, 2.22, abcd
4) 3, 4.4, X
5) 2,22
*/

open System.Text
open System.Globalization

let sb = StringBuilder()

let show (sbs: StringBuilder) =
    printfn $"{sbs}"
    sb.Length <- 0

let var1 = 111
let var2 = 2.22f
let var3 = "abcd"
let var4: obj[] = [| 3; 4.4; 'X' |]

printfn "StringBuilder.AppendFormat method:"
sb.AppendFormat("1) {0}", var1) |> ignore
show sb
sb.AppendFormat("2) {0}, {1}", var1, var2) |> ignore
show sb
sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3) |> ignore
show sb
sb.AppendFormat("4) {0}, {1}, {2}", var4) |> ignore
show sb
let ci = CultureInfo("es-ES", true)
sb.AppendFormat(ci, "5) {0}", var2) |> ignore
show sb

// This example produces the following results:
//       StringBuilder.AppendFormat method:
//       1) 111
//       2) 111, 2.22
//       3) 111, 2.22, abcd
//       4) 3, 4.4, X
//       5) 2,22

Imports System.Text
Imports System.Globalization

Class Sample
   Private Shared sb As New StringBuilder()

   Public Shared Sub Main()
      Dim var1 As Integer = 111
      Dim var2 As Single = 2.22F
      Dim var3 As String = "abcd"
      Dim var4 As Object() =  {3, 4.4, "X"c}
      
      Console.WriteLine()
      Console.WriteLine("StringBuilder.AppendFormat method:")
      sb.AppendFormat("1) {0}", var1)
      Show(sb)
      sb.AppendFormat("2) {0}, {1}", var1, var2)
      Show(sb)
      sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3)
      Show(sb)
      sb.AppendFormat("4) {0}, {1}, {2}", var4)
      Show(sb)
      Dim ci As New CultureInfo("es-ES", True)
      sb.AppendFormat(ci, "5) {0}", var2)
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Console.WriteLine(sbs.ToString())
      sb.Length = 0
   End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.AppendFormat method:
'1) 111
'2) 111, 2.22
'3) 111, 2.22, abcd
'4) 3, 4.4, X
'5) 2,22

Opmerkingen

De format parameter bestaat uit nul of meer uitvoeringen van tekst die is gemengd met nul of meer geïndexeerde tijdelijke aanduidingen, genaamd opmaakitems. De index van de notatie-items moet 0 zijn, zodat deze overeenkomt met arg0het object in de parameterlijst van deze methode. Het opmaakproces vervangt elk opmaakitem door de tekenreeksweergave van arg0.

De syntaxis van een opmaakitem is als volgt:

{index[,length][:formatString]}

Elementen in vierkante haken zijn optioneel. In de volgende tabel wordt elk element beschreven.

Element	Description
index	De op nul gebaseerde positie in de parameterlijst van het object dat moet worden opgemaakt. Als het object dat door de index is `null`opgegeven, wordt het opmaakitem vervangen door String.Empty. Als er geen parameter in de indexpositie staat, wordt er een FormatException gegenereerd.
,lengte	Het minimale aantal tekens in de tekenreeksweergave van de parameter. Indien positief, wordt de parameter rechts uitgelijnd; als dit negatief is, wordt deze links uitgelijnd.
:formatString	Een standaard- of aangepaste notatietekenreeks die wordt ondersteund door de parameter.

Note

arg0 vertegenwoordigt het object dat moet worden opgemaakt. Elk opmaakitem wordt format vervangen door de tekenreeksweergave van arg0. Als het opmaakitem de IFormattable interface bevat formatString en arg0 implementeert, arg0.ToString(formatString, null) definieert u de opmaak. arg0.ToString() Anders definieert u de opmaak.

Notities voor bellers

Zie ook

Van toepassing op

AppendFormat(IFormatProvider, String, Object[])

public:
 System::Text::StringBuilder ^ AppendFormat(IFormatProvider ^ provider, System::String ^ format, ... cli::array <System::Object ^> ^ args);

public System.Text.StringBuilder AppendFormat(IFormatProvider provider, string format, params object[] args);

member this.AppendFormat : IFormatProvider * string * obj[] -> System.Text.StringBuilder

Public Function AppendFormat (provider As IFormatProvider, format As String, ParamArray args As Object()) As StringBuilder

Parameters

provider: IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie levert.

format: String

Een tekenreeks met samengestelde notatie.

args: Object[]

Een matrix met objecten die moeten worden opgemaakt.

Retouren

StringBuilder

Uitzonderingen

ArgumentNullException

format is null.

FormatException

format is ongeldig.

– of –

De index van een opmaakitem is kleiner dan 0 (nul) of groter dan of gelijk aan de lengte van de args matrix.

ArgumentOutOfRangeException

De lengte van de uitgevouwen tekenreeks zou groter zijn dan MaxCapacity.

Voorbeelden

In het volgende voorbeeld ziet u de AppendFormat methode.

using System;
using System.Text;
using System.Globalization;

class Sample
{
    static StringBuilder sb = new StringBuilder();

    public static void Main()
    {
    int    var1   = 111;
    float  var2   = 2.22F;
    string var3   = "abcd";
    object[] var4 = {3, 4.4, 'X'};

    Console.WriteLine();
    Console.WriteLine("StringBuilder.AppendFormat method:");
    sb.AppendFormat("1) {0}", var1);
    Show(sb);
    sb.AppendFormat("2) {0}, {1}", var1, var2);
    Show(sb);
    sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3);
    Show(sb);
    sb.AppendFormat("4) {0}, {1}, {2}", var4);
    Show(sb);
    CultureInfo ci = new CultureInfo("es-ES", true);
    sb.AppendFormat(ci, "5) {0}", var2);
    Show(sb);
    }

    public static void Show(StringBuilder sbs)
    {
    Console.WriteLine(sbs.ToString());
    sb.Length = 0;
    }
}
/*
This example produces the following results:

StringBuilder.AppendFormat method:
1) 111
2) 111, 2.22
3) 111, 2.22, abcd
4) 3, 4.4, X
5) 2,22
*/

open System.Text
open System.Globalization

let sb = StringBuilder()

let show (sbs: StringBuilder) =
    printfn $"{sbs}"
    sb.Length <- 0

let var1 = 111
let var2 = 2.22f
let var3 = "abcd"
let var4: obj[] = [| 3; 4.4; 'X' |]

printfn "StringBuilder.AppendFormat method:"
sb.AppendFormat("1) {0}", var1) |> ignore
show sb
sb.AppendFormat("2) {0}, {1}", var1, var2) |> ignore
show sb
sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3) |> ignore
show sb
sb.AppendFormat("4) {0}, {1}, {2}", var4) |> ignore
show sb
let ci = CultureInfo("es-ES", true)
sb.AppendFormat(ci, "5) {0}", var2) |> ignore
show sb

// This example produces the following results:
//       StringBuilder.AppendFormat method:
//       1) 111
//       2) 111, 2.22
//       3) 111, 2.22, abcd
//       4) 3, 4.4, X
//       5) 2,22

Imports System.Text
Imports System.Globalization

Class Sample
   Private Shared sb As New StringBuilder()

   Public Shared Sub Main()
      Dim var1 As Integer = 111
      Dim var2 As Single = 2.22F
      Dim var3 As String = "abcd"
      Dim var4 As Object() =  {3, 4.4, "X"c}
      
      Console.WriteLine()
      Console.WriteLine("StringBuilder.AppendFormat method:")
      sb.AppendFormat("1) {0}", var1)
      Show(sb)
      sb.AppendFormat("2) {0}, {1}", var1, var2)
      Show(sb)
      sb.AppendFormat("3) {0}, {1}, {2}", var1, var2, var3)
      Show(sb)
      sb.AppendFormat("4) {0}, {1}, {2}", var4)
      Show(sb)
      Dim ci As New CultureInfo("es-ES", True)
      sb.AppendFormat(ci, "5) {0}", var2)
      Show(sb)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Console.WriteLine(sbs.ToString())
      sb.Length = 0
   End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.AppendFormat method:
'1) 111
'2) 111, 2.22
'3) 111, 2.22, abcd
'4) 3, 4.4, X
'5) 2,22

In het volgende voorbeeld wordt een aangepaste IFormatProvider implementatie gedefinieerd met de naam CustomerFormatter waarmee een klantnummer van 10 cijfers wordt opgemaakt met afbreekstreepjes na de vierde en zevende cijfers. Deze wordt doorgegeven aan de StringBuilder.AppendFormat(IFormatProvider, String, Object[]) methode om een tekenreeks te maken die het opgemaakte klantnummer en de klantnaam bevat.

using System;
using System.Text;

public class Customer
{
   private string custName;
   private int custNumber;
   
   public Customer(string name, int number)
   {
      this.custName = name;
      this.custNumber = number;
   }
   
   public string Name
   {
      get { return this.custName; }
   }
   
   public int CustomerNumber
   {
      get { return this.custNumber; }
   }
}

public class CustomerNumberFormatter : IFormatProvider, ICustomFormatter
{   
   public object GetFormat(Type formatType)
   {
      if (formatType == typeof(ICustomFormatter))
         return this;
      return null;
   }
   
   public string Format(string format, object arg, IFormatProvider provider)
   {
      if (arg is Int32)
      {
         string custNumber = ((int) arg).ToString("D10");
         return custNumber.Substring(0, 4) + "-" + custNumber.Substring(4, 3) + 
                "-" + custNumber.Substring(7, 3);
      }
      else
      {
         return null;
      }
   }                   
}

public class Example
{
   public static void Main()
   {
      Customer customer = new Customer("A Plus Software", 903654);
      StringBuilder sb = new StringBuilder();
      sb.AppendFormat(new CustomerNumberFormatter(), "{0}: {1}", 
                      customer.CustomerNumber, customer.Name);
      Console.WriteLine(sb.ToString());
   }
}
// The example displays the following output:
//      0000-903-654: A Plus Software

open System
open System.Text

type Customer(name: string, number: int) =
    member _.Name = name
    member _.CustomerNumber = number

type CustomerNumberFormatter() =
    interface IFormatProvider with
        member this.GetFormat(formatType) =
            if formatType = typeof<ICustomFormatter> then this else null

    interface ICustomFormatter with
        member _.Format(_, arg, _) =
            match arg with
            | :? int as i ->
                let custNumber = i.ToString "D10"
                $"{custNumber.Substring(0, 4)}-{custNumber.Substring(4, 3)}-{custNumber.Substring(7, 3)}"
            | _ -> null

let customer = Customer("A Plus Software", 903654)
let sb = StringBuilder()

sb.AppendFormat(CustomerNumberFormatter(), "{0}: {1}", customer.CustomerNumber, customer.Name)
|> ignore

printfn $"{sb}"

// The example displays the following output:
//      0000-903-654: A Plus Software

Imports System.Text

Public Class Customer
   Private custName As String
   Private custNumber As Integer
   
   Public Sub New(name As String, number As Integer)
      custName = name
      custNumber = number
   End Sub
   
   Public ReadOnly Property Name As String
      Get
         Return Me.custName
      End Get
   End Property
   
   Public ReadOnly Property CustomerNumber As Integer
      Get
         Return Me.custNumber
      End Get
   End Property
End Class

Public Class CustomerNumberFormatter 
   Implements IFormatProvider, ICustomFormatter
   
   Public Function GetFormat(formatType As Type) As Object _
                   Implements IFormatProvider.GetFormat
      If formatType Is GetType(ICustomFormatter) Then
         Return Me
      End If
      Return Nothing
   End Function
   
   Public Function Format(fmt As String, arg As Object, provider As IFormatProvider) As String _
                   Implements ICustomFormatter.Format
      If typeof arg Is Int32 Then
         Dim custNumber As String = CInt(arg).ToString("D10")
         Return custNumber.Substring(0, 4) + "-" + custNumber.SubString(4, 3) + _
                "-" + custNumber.Substring(7, 3)
      Else
         Return Nothing
      End If
   End Function                   
End Class

Module Example
   Public Sub Main()
      Dim customer As New Customer("A Plus Software", 903654)
      Dim sb As New StringBuilder()
      sb.AppendFormat(New CustomerNumberFormatter, "{0}: {1}", _
                      customer.CustomerNumber, customer.Name)
      Console.WriteLine(sb.ToString())
   End Sub
End Module
' The example displays the following output:
'      0000-903-654: A Plus Software

Opmerkingen

De format parameter bestaat uit nul of meer uitvoeringen van tekst die is gemengd met nul of meer geïndexeerde tijdelijke aanduidingen, genaamd notatie-items, die overeenkomen met objecten in de parameterlijst van deze methode. Het opmaakproces vervangt elk opmaakitem door de tekenreeksweergave van het bijbehorende object.

De syntaxis van een opmaakitem is als volgt:

{index[,length][:formatString]}

Elementen in vierkante haken zijn optioneel. In de volgende tabel wordt elk element beschreven.

Element	Description
index	De op nul gebaseerde positie in de parameterlijst van het object dat moet worden opgemaakt. Als het object dat door de index is `null`opgegeven, wordt het opmaakitem vervangen door String.Empty. Als er geen parameter in de indexpositie staat, wordt er een FormatException gegenereerd.
,lengte	Het minimale aantal tekens in de tekenreeksweergave van de parameter. Indien positief, wordt de parameter rechts uitgelijnd; als dit negatief is, wordt deze links uitgelijnd.
:formatString	Een standaard- of aangepaste notatietekenreeks die wordt ondersteund door de parameter.

Note

Met provider de parameter geeft u een IFormatProvider implementatie op die opmaakinformatie kan bieden voor de objecten in args. provider kan een van de volgende zijn:

Een CultureInfo object dat cultuurspecifieke opmaakinformatie biedt.
Een NumberFormatInfo object dat cultuurspecifieke opmaakinformatie biedt voor numerieke waarden in args.
Een DateTimeFormatInfo object dat cultuurspecifieke opmaakinformatie biedt voor datum- en tijdwaarden in args.
Een aangepaste IFormatProvider implementatie die opmaakinformatie biedt voor een of meer van de objecten in args. Normaal gesproken implementeert een dergelijke implementatie ook de ICustomFormatter interface. In het tweede voorbeeld in de volgende sectie ziet u een methodeaanroep StringBuilder.AppendFormat(IFormatProvider, String, Object[]) met een aangepaste IFormatProvider implementatie.

Als de provider parameter is null, wordt de providergegevens van de indeling verkregen uit de huidige cultuur.

Notities voor bellers

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?