NamedRange.NumberFormat-Eigenschaft

Artikel
08/10/2011

Ruft den Formatierungscode für das NamedRange-Steuerelement ab oder legt diesen fest.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
Property NumberFormat As Object
    Get
    Set

Object NumberFormat { get; set; }

Eigenschaftswert

Typ: System.Object
Der Formatierungscode für das NamedRange-Steuerelement.

Hinweise

Diese Eigenschaft gibt nullNULL-Verweis (Nothing in Visual Basic) zurück, wenn alle Zellen im NamedRange-Steuerelement unterschiedliche Zahlenformate aufweisen.

Der Formatierungscode ist dieselbe Zeichenfolge wie die Option Formatierungscode im Dialogfeld Zellen formatieren. Die Format-Funktion verwendet andere Formatierungscodezeichenfolgen als die NumberFormat-Eigenschaft und die NumberFormatLocal-Eigenschaft.

Beispiele

Im folgenden Codebeispiel wird mithilfe der NumberFormat-Eigenschaft eine Datumszeichenfolge in einem NamedRange formatiert. Weiterhin wird in diesem Beispiel die NumberFormatLocal-Eigenschaft verwendet, um das Datumsformat in der Sprache des Benutzers anzuzeigen.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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());
}

.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.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Share via