NamedRange.Parse Метод (2007 System)
Обновлен: Ноябрь 2007
Проводит синтаксический анализ диапазона данных и разбивает его на несколько ячеек.
Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)
Синтаксис
'Декларация
Public Function Parse ( _
ParseLine As Object, _
Destination As Object _
) As Object
'Применение
Dim instance As NamedRange
Dim ParseLine As Object
Dim Destination As Object
Dim returnValue As Object
returnValue = instance.Parse(ParseLine, _
Destination)
public Object Parse(
Object ParseLine,
Object Destination
)
Параметры
- ParseLine
Тип: System.Object
Строка, содержащая левую и правую скобки, для указания, где должны разбиваться ячейки.
Например, "[xxx][xxx]" вставит первые три символа в первый столбец диапазона назначения, а затем вставит следующие три символа во второй столбец.
Если этот аргумент не указывается, Microsoft Office Excel оценивает, как нужно разделить столбцы, на основании интервала для верхней левой ячейки в диапазоне. Если нужно использовать другой диапазон для оценки анализируемой строки, используйте объект Microsoft.Office.Interop.Excel.Range как аргумент ParseLine. Этот диапазон должен быть диапазоном ячеек, в которых выполняется синтаксический анализ. Аргумент ParseLine не может иметь более 255 символов, включая скобки и пробелы.
- Destination
Тип: System.Object
Объект Microsoft.Office.Interop.Excel.Range, представляющий верхний левый угол конечного диапазона для анализируемых данных. Если этот аргумент не указывается, Excel выполняет анализ на месте.
Возвращаемое значение
Тип: System.Object
Заметки
Распределяет содержимое элемента управления NamedRange для заполнения нескольких смежных столбцов. Элемент управления NamedRange не может иметь ширину, превышающую ширину одного столбца.
Примеры
В следующем примере кода метод Parse используется для анализа каждой группы чисел в наборе телефонных номеров из элемента управления NamedRange с именем NamedRange1 в новом диапазоне ячеек, начинающемся с ячейки D1.
В этом примере демонстрируется настройка уровня документа.
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]);
}
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.