Worksheet.Range, propriété
Obtient un objet Microsoft.Office.Interop.Excel.Range qui représente une cellule ou une plage de cellules.
Espace de noms : Microsoft.Office.Tools.Excel
Assemblys : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (dans Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Syntaxe
'Déclaration
ReadOnly Property Range As Worksheet_RangeType
Worksheet_RangeType Range { get; }
Valeur de propriété
Type : Microsoft.Office.Tools.Excel.Worksheet_RangeType
Microsoft.Office.Interop.Excel.Range qui représente une cellule ou une plage de cellules.
Notes
La propriété Range est destinée à être utilisée avec les paramètres suivants.
Paramètre |
Description |
|---|---|
Cell1 |
Nom de la plage dans la notation du style d'A1 dans le langage de l'application. Il peut inclure l'opérateur de plage (un deux-points), l'opérateur d'intersection (un espace) ou l'opérateur d'union (une virgule). Il peut inclure également des signes dollar, mais ils sont ignorés. Vous pouvez utiliser un nom défini par l'utilisateur local dans toute partie de la plage. Si vous utilisez un nom, celui-ci est considéré comme étant dans le langage de l'application. Ce paramètre est obligatoire. |
Cell2 |
La cellule dans le coin inférieur droit de la plage. Peut être un Microsoft.Office.Interop.Excel.Range qui contient une cellule seule, une colonne entière, une ligne entière ou une chaîne qui nomme une seule cellule dans le langage de l'application. Ce paramètre est optionnel. |
Si vous utilisez la propriété Range sans spécifier de paramètre, elle retourne un objet Worksheet_RangeType qui n'est pas destiné à être utilisé directement à partir de votre code.
Paramètres optionnels
Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.
Exemples
L'exemple de code suivant montre des façons différentes d'utiliser la propriété Range pour accéder à une seule cellule ou à plusieurs cellules.
Cet exemple est pour un complément d'application.
Private Sub CompareRangeUsage()
Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveWorksheet("Sheet1")
Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
Globals.Factory.GetVstoObject(NativeWorksheet)
' The following line of code specifies a single cell.
vstoWorksheet.Range("A1").Value2 = "Range 1"
' The following line of code specifies multiple cells.
vstoWorksheet.Range("A3", "B4").Value2 = "Range 2"
' The following line of code uses an Excel.Range for
' the second parameter of the Range property.
Dim range1 As Excel.Range = vstoWorksheet.Range("C8")
vstoWorksheet.Range("A6", range1).Value2 = "Range 3"
End Sub
private void CompareRangeUsage()
{
Worksheet vstoWorksheet = Globals.Factory.GetVstoObject(
this.Application.ActiveWorkbook.Worksheets[1]);
// The following line of code specifies a single cell.
vstoWorksheet.Range["A1"].Value2 = "Range 1";
// The following line of code specifies multiple cells.
vstoWorksheet.Range["A3", "B4"].Value2 = "Range 2";
// The following line of code uses an Excel.Range for
// the second parameter of the Range property.
Excel.Range range1 = vstoWorksheet.Range["C8"];
vstoWorksheet.Range["A6", range1].Value2 = "Range 3";
}
Sécurité .NET Framework
- 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.