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
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.
Voir aussi
Référence
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. |