NamedRange.Parse-Methode
Analysiert einen Datenbereich und teilt ihn in mehrere Zellen auf.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)
Syntax
'Declaration
Function Parse ( _
ParseLine As Object, _
Destination As Object _
) As Object
Object Parse(
Object ParseLine,
Object Destination
)
Parameter
- ParseLine
Typ: System.Object
Eine Zeichenfolge, die linke und rechte Klammern enthält, um anzuzeigen, wo die Zellen geteilt werden müssen.
Im Falle von "[xxx][xxx]" würden die ersten drei Zeichen in die erste Spalte des Zielbereichs und die nachfolgenden drei Zeichen in die zweite Spalte eingefügt werden.
Wenn dieses Argument weggelassen wird, ermittelt Microsoft Office Excel, an welcher Stelle die Spalten ausgehend vom Abstand der obersten linken Zelle im Bereich geteilt werden soll.Wenn Sie einen anderen Bereich zum Ermitteln der Analysezeile verwenden möchten, verwenden Sie ein Microsoft.Office.Interop.Excel.Range-Objekt als ParseLine-Argument.Bei dem Bereich muss es sich um eine der gerade analysierten Zellen handeln.Das ParseLine-Argument darf einschließlich Klammern und Leerzeichen höchstens 255 Zeichen lang sein.
- Destination
Typ: System.Object
Ein Microsoft.Office.Interop.Excel.Range-Objekt, das die linke obere Ecke des Zielbereichs der analysierten Daten darstellt.Wenn dieses Argument weggelassen wird, führt Excel die Analyse an der Stelle aus.
Rückgabewert
Typ: System.Object
Hinweise
Verteilt den Inhalt des NamedRange-Steuerelements, um mehrere benachbarte Spalten auszufüllen. Die Breite des NamedRange-Steuerelements darf höchstens eine Spalte betragen.
Beispiele
Im folgenden Codebeispiel wird die Parse-Methode verwendet, um jede Gruppe von Zahlen in einer Reihe von Telefonnummern in einem NamedRange-Steuerelement mit dem Namen NamedRange1 zu analysieren und in einen neuen Zellbereich einzufügen, der bei Zelle D1 beginnt.
Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.
Private Sub ParsePhoneNumbers()
Me.Range("A1").Value2 = "'5555550100'"
Me.Range("A2").Value2 = "'2065550101'"
Me.Range("A3").Value2 = "'4255550102'"
Me.Range("A4").Value2 = "'4155550103'"
Me.Range("A5").Value2 = "'5105550104'"
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
"namedRange1")
' Parse the phone numbers and insert them into
' the range starting at D1.
namedRange1.Parse("[XXX][XXX][XXXX]", Me.Range("D1"))
End Sub
private void ParsePhoneNumbers()
{
this.Range["A1", missing].Value2 = "'5555550100'";
this.Range["A2", missing].Value2 = "'2065550101'";
this.Range["A3", missing].Value2 = "'4255550102'";
this.Range["A4", missing].Value2 = "'4155550103'";
this.Range["A5", missing].Value2 = "'5105550104'";
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1", "A5"],
"namedRange1");
// Parse the phone numbers and insert them into
// the range starting at D1.
namedRange1.Parse("[XXX][XXX][XXXX]",
this.Range["D1", missing]);
}
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.