NamedRange.AddressLocal, propriété (System 2007)

Mise à jour : Juillet 2008

Obtient la référence de plage du contrôle NamedRange dans la langue de l'utilisateur.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel.v9.0 (dans Microsoft.Office.Tools.Excel.v9.0.dll)

Syntaxe

<BrowsableAttribute(False)> _
Public ReadOnly Property AddressLocal As NamedRange..::._AddressLocalType

Dim instance As NamedRange
Dim value As NamedRange..::._AddressLocalType

value = instance.AddressLocal
[BrowsableAttribute(false)]
public NamedRange..::._AddressLocalType AddressLocal { get; }

Valeur de propriété

Type : Microsoft.Office.Tools.Excel.NamedRange._AddressLocalType

Chaîne qui représente la référence de plage du contrôle NamedRange dans la langue de l'utilisateur et en notation R1C1 ou A1.

Notes

La propriété AddressLocal doit être utilisée avec les paramètres suivants.

Paramètre

Description

RowAbsolute

true pour retourner la ligne sous la forme d'une référence absolue. La valeur par défaut est true.

ColumnAbsolute

true pour retourner la colonne sous la forme d'une référence absolue. La valeur par défaut est true.

ColumnAbsolute

Une des valeurs de XlReferenceStyle.

External

true pour retourner une référence externe ; false pour retourner une référence locale. La valeur par défaut est false.

RelativeTo

Range qui définit le point de départ. Si RowAbsolute et ColumnAbsolute sont false, et si ReferenceStyle est xlR1C1, vous devez inclure un point de départ pour la référence relative.

Si vous essayez d'utiliser AddressLocal sans spécifier de paramètres, AddressLocal obtient un objet NamedRange._AddressLocalType qui fait partie de l'infrastructure de Visual Studio Tools pour Office et n'est pas conçu pour être utilisé directement à partir de votre code.

Si la référence contient plusieurs cellules, RowAbsolute et ColumnAbsolute s'appliquent à toutes les lignes et à toutes les colonnes.

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Fonctionnement des paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant crée un NamedRange, puis affiche l'adresse de NamedRange dans quatre formats. Si l'exemple est exécuté sur un système qui prend en charge l'allemand, l'exemple affiche les chaînes d'adresse "$A$2", "$A2", "Z2S2" et "Z[-1]S[-1]".

Cette version est destinée à une personnalisation au niveau du document.

Private Sub DisplayAddressLocal()
    'Change system settings to German and test this.
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A2", "C4"), _
        "namedRange1")

    ' The following code will display "$A$2".
    MessageBox.Show(namedRange1.AddressLocal(True, True, _
        Excel.XlReferenceStyle.xlA1, False, ))

    ' The following code will display "$A2".
    MessageBox.Show(namedRange1.AddressLocal(False, True, _
        Excel.XlReferenceStyle.xlA1, False, ))

    ' The following code will display "Z2S2".
    MessageBox.Show(namedRange1.AddressLocal(True, True, _
        Excel.XlReferenceStyle.xlR1C1, False, ))

    ' The following code will display "Z[-1]S[-1]".
    MessageBox.Show(namedRange1.AddressLocal(False, False, _
        Excel.XlReferenceStyle.xlR1C1, False, Me.Cells(3, 3)))
End Sub

private void DisplayAddressLocal()
{
    //Change system settings to German and test this.
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A2", "C4"],
        "namedRange1");

    // The following code will display "$A$2".
    MessageBox.Show(namedRange1.AddressLocal[true,
        true, Excel.XlReferenceStyle.xlA1, false, missing]);

    // The following code will display "$A2".
    MessageBox.Show(namedRange1.AddressLocal[false,
        true, Excel.XlReferenceStyle.xlA1, false, missing]);

    // The following code will display "Z2S2".
    MessageBox.Show(namedRange1.AddressLocal[true,
         true, Excel.XlReferenceStyle.xlR1C1, false, missing]);

    // The following code will display "Z[-1]S[-1]".
    MessageBox.Show(namedRange1.AddressLocal[false,
        false, Excel.XlReferenceStyle.xlR1C1, false, this.Cells[3, 3]]);
}

Cette version est destinée à un complément d'application.

Private Sub DisplayAddressLocal()
    Dim vstoWorksheet As Worksheet = CType( _
        Me.Application.ActiveWorkbook.Worksheets(1),  _
        Excel.Worksheet).GetVstoObject()
    'Change system settings to German and test this.
    Dim namedRange1 As NamedRange _
        = vstoWorksheet.Controls.AddNamedRange(vstoWorksheet.Range("A2", "C4"), _
        "namedRange1")

    ' The following code will display "$A$2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal(True, True, _
        Excel.XlReferenceStyle.xlA1, False, ))

    ' The following code will display "$A2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal(False, True, _
        Excel.XlReferenceStyle.xlA1, False, ))

    ' The following code will display "Z2S2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal(True, True, _
        Excel.XlReferenceStyle.xlR1C1, False, ))

    ' The following code will display "Z[-1]S[-1]".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal(False, False, _
        Excel.XlReferenceStyle.xlR1C1, False, vstoWorksheet.Cells(3, 3)))
End Sub
private void DisplayAddressLocal()
{
    Worksheet vstoWorksheet = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    //Change system settings to German and test this.
    NamedRange namedRange1 =
        vstoWorksheet.Controls.AddNamedRange(
        vstoWorksheet.Range["A2", "C4"],
        "namedRange1");

    // The following code will display "$A$2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal[true,
        true, Excel.XlReferenceStyle.xlA1, false, missing]);

    // The following code will display "$A2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal[false,
        true, Excel.XlReferenceStyle.xlA1, false, missing]);

    // The following code will display "Z2S2".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal[true,
         true, Excel.XlReferenceStyle.xlR1C1, false, missing]);

    // The following code will display "Z[-1]S[-1]".
    System.Windows.Forms.MessageBox.Show(namedRange1.AddressLocal[false,
        false, Excel.XlReferenceStyle.xlR1C1, false, 
        vstoWorksheet.Cells[3, 3]]);
}

Autorisations

Voir aussi

Référence

NamedRange, classe

Membres NamedRange

Microsoft.Office.Tools.Excel, espace de noms

Historique des modifications

Date

Historique

Raison

Juillet 2008

Ajout d'une version de l'exemple de code pour un complément d'application.

Modifications de fonctionnalités dans le SP1.