成員存取運算子和運算式 (c # 參考)

當您存取型別成員時,可以使用下列運算子和運算式:

成員存取運算式。

您會使用 . 語彙基元來存取命名空間或類型的成員,如下列範例所示:

  • . 來存取命名空間內的嵌套命名空間,如下列指示 using 詞的範例所示:

    using System.Collections.Generic;
    
  • 使用 . 來形成「限定名稱」以存取命名空間內的類型,如下列程式碼所示:

    System.Collections.Generic.IEnumerable<int> numbers = new int[] { 1, 2, 3 };
    

    使用指示 using 詞,讓限定名稱的使用為選擇性。

  • 使用 . 來存取類型成員 (靜態及非靜態),如下列程式碼所示:

    var constants = new List<double>();
    constants.Add(Math.PI);
    constants.Add(Math.E);
    Console.WriteLine($"{constants.Count} values to show:");
    Console.WriteLine(string.Join(", ", constants));
    // Output:
    // 2 values to show:
    // 3.14159265358979, 2.71828182845905
    

您也可以使用 . 來存取擴充方法

索引子運算子 []

中括弧 ([]) 通常用於陣列、索引子或指標元素存取。

陣列存取

以下範例將示範如何存取陣列元素:

int[] fib = new int[10];
fib[0] = fib[1] = 1;
for (int i = 2; i < fib.Length; i++)
{
    fib[i] = fib[i - 1] + fib[i - 2];
}
Console.WriteLine(fib[fib.Length - 1]);  // output: 55

double[,] matrix = new double[2,2];
matrix[0,0] = 1.0;
matrix[0,1] = 2.0;
matrix[1,0] = matrix[1,1] = 3.0;
var determinant = matrix[0,0] * matrix[1,1] - matrix[1,0] * matrix[0,1];
Console.WriteLine(determinant);  // output: -3

如果陣列索引超出陣列的對應維度界限,就會擲回 IndexOutOfRangeException

如上述範例所示,您也會在宣告陣列類型或將陣列執行個體具現化時使用方括弧。

如需陣列的詳細資訊,請參閱陣列

索引子存取

下列範例會使用 .NET Dictionary<TKey,TValue> 型別來示範索引子存取:

var dict = new Dictionary<string, double>();
dict["one"] = 1;
dict["pi"] = Math.PI;
Console.WriteLine(dict["one"] + dict["pi"]);  // output: 4.14159265358979

索引子可讓您透過與陣列編製索引類似的方式,為使用者定義型別的執行個體編製索引。 不同于陣列索引(必須為整數),索引子參數可以宣告為任何類型。

如需索引子的詳細資訊,請參閱索引子

[] 的其他用法

如需有關指標元素存取的相關資訊,請參閱指標相關運算子一文的指標元素存取運算子 [] 一節。

您也可以使用中括弧來指定屬性

[System.Diagnostics.Conditional("DEBUG")]
void TraceMethod() {}

Null 條件運算子 ?. 和 ?[]

在 c # 6 和更新版本中提供,null 條件運算子 ?. 只會在運算元評估為非 null 的情況下,將成員存取、或專案存取權套用 ?[] 至其運算元,否則會傳回 null 。 那是

  • 如果 a 評估為 null ,則或的 a?.x 結果 a?[x]null

  • 如果 a 評估為非 null,或的結果 a?.x a?[x] 會分別與或的結果相同 a.x a[x]

    注意

    如果 a.xa[x] 擲回例外狀況, a?.xa?[x] 針對非 null 擲回相同的例外狀況 a 。 例如,如果 a 是非 null 的陣列實例,且超出 x 的範圍 a ,則 a?[x] 會擲回 IndexOutOfRangeException

Null 條件運算子會執行最少運算。 換句話說,如果條件式成員或項目存取作業鏈結中的一個作業傳回 null,則鏈結的其餘部分不會執行。 在下列範例中,如果 A 評估為 null,則不會評估 B;如果 AB 評估為 null,則不會評估 C

A?.B?.Do(C);
A?.B?[C];

下列範例示範 ?.?[] 運算子的用法:

double SumNumbers(List<double[]> setsOfNumbers, int indexOfSetToSum)
{
    return setsOfNumbers?[indexOfSetToSum]?.Sum() ?? double.NaN;
}

var sum1 = SumNumbers(null, 0);
Console.WriteLine(sum1);  // output: NaN

var numberSets = new List<double[]>
{
    new[] { 1.0, 2.0, 3.0 },
    null
};

var sum2 = SumNumbers(numberSets, 0);
Console.WriteLine(sum2);  // output: 6

var sum3 = SumNumbers(numberSets, 1);
Console.WriteLine(sum3);  // output: NaN

上述範例也會使用null 聯合運算子 ?? 來指定替代運算式,以在 null 條件運算的結果為時進行評估 null

如果 a.xa[x] 為不可為 null 的實值型別 Ta?.xa?[x] 為對應的 可為 null 實值型T? 。 如果您需要類型的運算式 T ,請將 null 聯合運算子套用 ?? 至 null 條件運算式,如下列範例所示:

int GetSumOfFirstTwoOrDefault(int[] numbers)
{
    if ((numbers?.Length ?? 0) < 2)
    {
        return 0;
    }
    return numbers[0] + numbers[1];
}

Console.WriteLine(GetSumOfFirstTwoOrDefault(null));  // output: 0
Console.WriteLine(GetSumOfFirstTwoOrDefault(new int[0]));  // output: 0
Console.WriteLine(GetSumOfFirstTwoOrDefault(new[] { 3, 4, 5 }));  // output: 7

在上述範例中,如果您未使用 ?? 運算子,則 numbers?.Length < 2 會在 false 是時評估為 numbers null

Null 條件成員存取運算子 ?. 也被稱為 Elvis 運算子。

安全執行緒委派引動流程

使用 ?. 運算子來檢查委派是否為非 Null,然後以安全執行緒方式叫用它 (例如當您引發事件時),如下列程式碼所示:

PropertyChanged?.Invoke(…)

該程式碼等同於您用於 C# 5 或舊版的下列程式碼:

var handler = this.PropertyChanged;
if (handler != null)
{
    handler(…);
}

這是一種安全線程的方法,可確保只叫用非 null handler 。 因為委派實例是不可變的,所以沒有任何執行緒可以變更本機變數參考的物件 handler 。 尤其是,如果另一個執行緒執行的程式碼從事件取消訂閱,並在叫用 PropertyChanged PropertyChanged null 之前變成 handler ,則參考的物件會 handler 保持不受影響。 ?.運算子會評估其左邊運算元不超過一次,以保證在 null 驗證為非 null 之後,無法將其變更為。

調用運算式 ()

使用括弧 () 來呼叫方法或叫用委派

下列範例示範如何呼叫方法 (使用或不使用引數),以及叫用委派:

Action<int> display = s => Console.WriteLine(s);

var numbers = new List<int>();
numbers.Add(10);
numbers.Add(17);
display(numbers.Count);   // output: 2

numbers.Clear();
display(numbers.Count);   // output: 0

當您使用 new 運算子叫用建構函式時,您也會使用括號。

() 的其他用法

您也可以使用括弧來調整評估運算式中作業的順序。 如需詳細資訊,請參閱 C# 運算子

Cast 運算式 (其能執行明確類型轉換) 也會使用括號。

End 運算子 ^ 的索引

在 c # 8.0 和更新版本中提供, ^ 運算子表示從序列結尾開始的元素位置。 針對長度的序列 length^n 指向具有 length - n 從序列開頭位移的元素。 例如, ^1 指向序列的最後一個元素,並 ^length 指向序列的第一個專案。

int[] xs = new[] { 0, 10, 20, 30, 40 };
int last = xs[^1];
Console.WriteLine(last);  // output: 40

var lines = new List<string> { "one", "two", "three", "four" };
string prelast = lines[^2];
Console.WriteLine(prelast);  // output: three

string word = "Twenty";
Index toFirst = ^word.Length;
char first = word[toFirst];
Console.WriteLine(first);  // output: T

如上一個範例所示,expression 的型別為 ^e System.Index 。 在運算式中 ^e ,的結果 e 必須可以隱含地轉換成 int

您也可以搭配使用 ^ 運算子與 範圍運算子 來建立索引的範圍。 如需詳細資訊,請參閱 索引和範圍

範圍運算子。

在 c # 8.0 和更新版本中提供, .. 運算子會指定索引範圍的開頭和結尾作為其運算元。 左邊 運算元是範圍的開頭。 右邊運算元是範圍的 專屬 結尾。 其中一個運算元可以是從序列開頭或結尾的索引,如下列範例所示:

int[] numbers = new[] { 0, 10, 20, 30, 40, 50 };
int start = 1;
int amountToTake = 3;
int[] subset = numbers[start..(start + amountToTake)];
Display(subset);  // output: 10 20 30

int margin = 1;
int[] inner = numbers[margin..^margin];
Display(inner);  // output: 10 20 30 40

string line = "one two three";
int amountToTakeFromEnd = 5;
Range endIndices = ^amountToTakeFromEnd..^0;
string end = line[endIndices];
Console.WriteLine(end);  // output: three

void Display<T>(IEnumerable<T> xs) => Console.WriteLine(string.Join(" ", xs));

如上一個範例所示,expression 的型別為 a..b System.Range 。 在 [運算式] 中 a..ba 和的結果 b 必須可以隱含地轉換成 intIndex

您可以省略運算子的任何運算元 .. 來取得開放式範圍:

  • a.. 相當於 a..^0
  • ..b 相當於 0..b
  • .. 相當於 0..^0
int[] numbers = new[] { 0, 10, 20, 30, 40, 50 };
int amountToDrop = numbers.Length / 2;

int[] rightHalf = numbers[amountToDrop..];
Display(rightHalf);  // output: 30 40 50

int[] leftHalf = numbers[..^amountToDrop];
Display(leftHalf);  // output: 0 10 20

int[] all = numbers[..];
Display(all);  // output: 0 10 20 30 40 50

void Display<T>(IEnumerable<T> xs) => Console.WriteLine(string.Join(" ", xs));

如需詳細資訊,請參閱 索引和範圍

運算子是否可多載

.、、 () ^.. 運算子無法多載。 [] 運算子也會視為不可多載的運算子。 請使用索引子以支援使用使用者定義型別編製索引。

C# 語言規格

如需詳細資訊,請參閱 C# 語言規格的下列幾節:

如需有關索引和範圍的詳細資訊,請參閱 功能提案注意事項

另請參閱