NamedRange.NumberFormat Свойство (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Возвращает или задает код формата для элемента управления NamedRange.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public Property NumberFormat As Object
'Применение
Dim instance As NamedRange
Dim value As Object

value = instance.NumberFormat

instance.NumberFormat = value

[BrowsableAttribute(false)]
public Object NumberFormat { get; set; }

Значение свойства

Тип: System.Object
Код формата для элемента управления NamedRange.

Заметки

Это свойство возвращает nullссылка null (Nothing в Visual Basic), если не все ячейки в элементе управления NamedRange имеют одинаковый формат числа.

Кодом формата является та же строка, что и параметр Коды формата в диалоговом окне Ячейки формата. Функция Format использует иные строки кода формата, чем свойства NumberFormat и NumberFormatLocal.

Примеры

В следующем примере кода свойство NumberFormat используется для форматирования строки даты в NamedRange. В примере свойство NumberFormatLocal используется также для отображения формата даты на языке пользователя.

В этом примере демонстрируется настройка уровня документа.

Private formatRange As Microsoft.Office.Tools.Excel.NamedRange

Private Sub ApplyNumberFormatting()
    formatRange = Me.Controls.AddNamedRange( _
        Me.Range("C1"), "formatRange")

    Me.formatRange.Value2 = "4-Apr-1974"
    Me.formatRange.NumberFormat = "m/d/yyyy"

    ' Display the number format in the language of the user.
    MessageBox.Show("The number format for the NamedRange is: " & _
        Me.formatRange.NumberFormatLocal.ToString())
End Sub

Microsoft.Office.Tools.Excel.NamedRange formatRange;
private void ApplyNumberFormatting()
{
    formatRange = this.Controls.AddNamedRange(
         this.Range["C1", missing], "formatRange");

    this.formatRange.Value2 = "4-Apr-1974";
    this.formatRange.NumberFormat = "m/d/yyyy";

    // Display the number format in the language of the user.
    MessageBox.Show("The number format for the NamedRange is: " +
        this.formatRange.NumberFormatLocal.ToString());
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

NamedRange Класс

NamedRange - члены

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через