StringCollection.AddRange(String[]) Methode
Definitie
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.
Kopieert de elementen van een tekenreeksmatrix naar het einde van de StringCollectionmatrix.
public:
void AddRange(cli::array <System::String ^> ^ value);
public void AddRange(string[] value);
public void AddRange(string?[] value);
member this.AddRange : string[] -> unit
Public Sub AddRange (value As String())
Parameters
- value
- String[]
Een matrix met tekenreeksen die moeten worden toegevoegd aan het einde van de StringCollection. De matrix zelf kan niet zijn null , maar kan elementen bevatten die wel zijn null.
Uitzonderingen
value is null.
Voorbeelden
In het volgende codevoorbeeld worden nieuwe elementen toegevoegd aan de StringCollection.
using System;
using System.Collections;
using System.Collections.Specialized;
public class SamplesStringCollection {
public static void Main() {
// Creates and initializes a new StringCollection.
StringCollection myCol = new StringCollection();
Console.WriteLine( "Initial contents of the StringCollection:" );
PrintValues( myCol );
// Adds a range of elements from an array to the end of the StringCollection.
String[] myArr = new String[] { "RED", "orange", "yellow", "RED", "green", "blue", "RED", "indigo", "violet", "RED" };
myCol.AddRange( myArr );
Console.WriteLine( "After adding a range of elements:" );
PrintValues( myCol );
// Adds one element to the end of the StringCollection and inserts another at index 3.
myCol.Add( "* white" );
myCol.Insert( 3, "* gray" );
Console.WriteLine( "After adding \"* white\" to the end and inserting \"* gray\" at index 3:" );
PrintValues( myCol );
}
public static void PrintValues( IEnumerable myCol ) {
foreach ( Object obj in myCol )
Console.WriteLine( " {0}", obj );
Console.WriteLine();
}
}
/*
This code produces the following output.
Initial contents of the StringCollection:
After adding a range of elements:
RED
orange
yellow
RED
green
blue
RED
indigo
violet
RED
After adding "* white" to the end and inserting "* gray" at index 3:
RED
orange
yellow
* gray
RED
green
blue
RED
indigo
violet
RED
* white
*/
Imports System.Collections
Imports System.Collections.Specialized
Public Class SamplesStringCollection
Public Shared Sub Main()
' Creates and initializes a new StringCollection.
Dim myCol As New StringCollection()
Console.WriteLine("Initial contents of the StringCollection:")
PrintValues(myCol)
' Adds a range of elements from an array to the end of the StringCollection.
Dim myArr() As [String] = {"RED", "orange", "yellow", "RED", "green", "blue", "RED", "indigo", "violet", "RED"}
myCol.AddRange(myArr)
Console.WriteLine("After adding a range of elements:")
PrintValues(myCol)
' Adds one element to the end of the StringCollection and inserts another at index 3.
myCol.Add("* white")
myCol.Insert(3, "* gray")
Console.WriteLine("After adding ""* white"" to the end and inserting ""* gray"" at index 3:")
PrintValues(myCol)
End Sub
Public Shared Sub PrintValues(myCol As IEnumerable)
Dim obj As [Object]
For Each obj In myCol
Console.WriteLine(" {0}", obj)
Next obj
Console.WriteLine()
End Sub
End Class
'This code produces the following output.
'
'Initial contents of the StringCollection:
'
'After adding a range of elements:
' RED
' orange
' yellow
' RED
' green
' blue
' RED
' indigo
' violet
' RED
'
'After adding "* white" to the end and inserting "* gray" at index 3:
' RED
' orange
' yellow
' * gray
' RED
' green
' blue
' RED
' indigo
' violet
' RED
' * white
'
Opmerkingen
StringCollection
null accepteert als een geldige waarde en staat dubbele elementen toe.
Als de StringCollection nieuwe elementen geschikt zijn zonder de capaciteit te vergroten, is deze methode een O(n)-bewerking, waarbij n het aantal elementen dat moet worden toegevoegd. Als de capaciteit moet worden verhoogd voor de nieuwe elementen, wordt deze methode een O(n + m)-bewerking, waarbij n het aantal elementen dat moet worden toegevoegd en m is.Count