Partager via


WorksheetBase.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
Assembly :  Microsoft.Office.Tools.Excel.v4.0.Utilities (dans Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

'Déclaration
Public ReadOnly Property Range As Worksheet_RangeType
public 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 en Visual Basic.

Si vous essayez d'utiliser Range sans spécifier de paramètres, Range obtiendra un objet _RangeType qui fait partie de l'infrastructure Visual Studio et n'est pas conçu pour ê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 illustre une personnalisation au niveau du document.

Private Sub CompareRangeUsage()
    ' The following line of code specifies a single cell.
    Me.Range("A1").Value2 = "Range 1"

    ' The following line of code specifies multiple cells.
    Me.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 = Me.Range("C8")
    Me.Range("A6", range1).Value2 = "Range 3"
End Sub
private void CompareRangeUsage()
{
    // The following line of code specifies a single cell.
    this.Range["A1"].Value2 = "Range 1";

    // The following line of code specifies multiple cells.
    this.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 = this.Range["C8"];
    this.Range["A6", range1].Value2 = "Range 3";
}

Sécurité .NET Framework

Voir aussi

Référence

WorksheetBase Classe

Microsoft.Office.Tools.Excel, espace de noms