Partager via


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

Voir aussi

Référence

Worksheet Interface

Microsoft.Office.Tools.Excel, espace de noms