ContextNodeCollection.CopyTo-Methode
Kopiert alle Elemente der aktuellen ContextNodeCollection in ein angegebenes eindimensionales Array, wobei der angegebene Index des Zielarrays verwendet wird.
Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)
Syntax
'Declaration
Public Sub CopyTo ( _
array As ContextNode(), _
index As Integer _
)
'Usage
Dim instance As ContextNodeCollection
Dim array As ContextNode()
Dim index As Integer
instance.CopyTo(array, index)
public void CopyTo(
ContextNode[] array,
int index
)
public:
void CopyTo(
array<ContextNode^>^ array,
int index
)
public void CopyTo(
ContextNode[] array,
int index
)
public function CopyTo(
array : ContextNode[],
index : int
)
Parameter
- array
Typ: array<System.Windows.Ink.ContextNode[]
Das eindimensionale Array, das die aus der Auflistung kopierten Elemente empfängt. Das Array muss nullbasierte Indizierung haben.
- index
Typ: System.Int32
Der nullbasierte Index im array-Parameter, an dem der Kopiervorgang beginnt.
Hinweise
Die Elemente werden in derselben Reihenfolge in das Array-Objekt kopiert, in der der Enumerator die ContextNodeCollection durchläuft.
Eine Ausnahme wird in den folgenden Fällen ausgelöst:
Der array-Parameter ist ein nullNULL-Verweis (Nothing in Visual Basic)-Verweis.
Der index-Parameter ist kleiner als 0 (null).
Der array-Parameter ist mehrdimensional.
Der index-Parameter ist größer oder gleich der Länge des array-Parameters.
Die Anzahl der Elemente in der Auflistung überschreitet den verfügbaren Platz vom index-Parameter bis zum Ende des Ziel-array-Parameters.
Der Typ der Auflistung wird automatisch in den Typ des Ziel-array-Parameters umgewandelt. Mit dieser Methode werden Elemente jedoch nur in Arrays kopiert, die denselben Typ wie die Elemente der Auflistung aufweisen, oder in Arrays vom Typ Object. Beim Versuch, in einen anderen Typ von Array zu kopieren, wird eine InvalidCastException-Ausnahme ausgelöst.
Beispiele
Im folgenden Beispiel wird ein einziger Teil eines Arrays der ContextNode-Objekte mit Absätzen aufgefüllt, die ein InkAnalyzer-Objekt mit dem Namen theInkAnalyzer finden kann. Das Array beginnt bei Index 1 (dem zweiten Element in einem nullbasierten Array) des Zielarrays paragraphArray. Das erste Element des Zielarrays (mit dem Index 0) wird leer gelassen.
Dim paragraphs As ContextNodeCollection = theInkAnalyzer.FindNodesOfType(ContextNodeType.Paragraph)
Dim paragraphArray(paragraphs.Count + 1) As ContextNode
paragraphs.CopyTo(paragraphArray, 1)
ContextNodeCollection paragraphs =
theInkAnalyzer.FindNodesOfType(ContextNodeType.Paragraph);
ContextNode[] paragraphArray = new ContextNode[paragraphs.Count + 1];
paragraphs.CopyTo(paragraphArray, 1);
Plattformen
Windows Vista
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0