If 演算子 (Visual Basic)If Operator (Visual Basic)

ショート サーキット評価を条件に応じて 2 つの値を返しますを使用します。Uses short-circuit evaluation to conditionally return one of two values. If演算子は、3 つの引数、または 2 つの引数を指定して呼び出すことができます。The If operator can be called with three arguments or with two arguments.

構文Syntax

If( [argument1,] argument2, argument3 )  

演算子は、3 つの引数で呼び出された場合If Operator Called with Three Arguments

ときにIfが呼び出された 3 つの引数を使用すると、最初の引数としてキャスト可能な値に評価する必要があります、Booleanです。When If is called by using three arguments, the first argument must evaluate to a value that can be cast as a Boolean. あるBooleanが評価され、返されるその他の 2 つの引数の値が決定されます。That Boolean value will determine which of the other two arguments is evaluated and returned. 次のリストの適用される場合にのみ、If演算子が 3 つの引数を使用して呼び出されました。The following list applies only when the If operator is called by using three arguments.

指定項目Parts

用語Term 定義Definition
argument1 必須。Required. BooleanBoolean. その他の引数を評価し、返すを決定します。Determines which of the other arguments to evaluate and return.
argument2 必須。Required. ObjectObject. 評価されると返される場合argument1に評価されるTrueです。Evaluated and returned if argument1 evaluates to True.
argument3 必須。Required. ObjectObject. 評価されると返される場合argument1に評価False場合argument1は、 Nullable Booleanに評価される変数Nothingです。Evaluated and returned if argument1 evaluates to False or if argument1 is a NullableBoolean variable that evaluates to Nothing.

Ifが 3 つの引数で呼び出される演算子の動作と同様に、IIf関数を使用する点を除いてショート サーキット評価します。An If operator that is called with three arguments works like an IIf function except that it uses short-circuit evaluation. IIf関数評価は常に 3 つすべての引数の一方、Ifを 3 つの引数を持つ演算子が評価される 2 つのみです。An IIf function always evaluates all three of its arguments, whereas an If operator that has three arguments evaluates only two of them. 最初のIf引数が評価され、結果としてキャスト、Boolean値、TrueまたはFalseです。The first If argument is evaluated and the result is cast as a Boolean value, True or False. 値が場合Trueargument2が評価され、その値が返されますが、argument3は評価されません。If the value is True, argument2 is evaluated and its value is returned, but argument3 is not evaluated. 場合の値、Boolean式がFalseargument3が評価され、その値が返されますが、argument2は評価されません。If the value of the Boolean expression is False, argument3 is evaluated and its value is returned, but argument2 is not evaluated. 次の例では、使用するIf3 つの引数を使用する場合。The following examples illustrate the use of If when three arguments are used:

' This statement prints TruePart, because the first argument is true.
Console.WriteLine(If(True, "TruePart", "FalsePart"))

' This statement prints FalsePart, because the first argument is false.
Console.WriteLine(If(False, "TruePart", "FalsePart"))

Dim number = 3
' With number set to 3, this statement prints Positive.
Console.WriteLine(If(number >= 0, "Positive", "Negative"))

number = -1
' With number set to -1, this statement prints Negative.
Console.WriteLine(If(number >= 0, "Positive", "Negative"))

次の例は、の値を示しています。 ショート サーキット評価します。The following example illustrates the value of short-circuit evaluation. 例では、変数に分割する 2 つの試行を示しています。number変数によってdivisor場合を除きますdivisorは 0 です。The example shows two attempts to divide variable number by variable divisor except when divisor is zero. その場合は、0 を返す必要があるし、は行われません、実行時エラーになるため、除算を実行します。In that case, a 0 should be returned, and no attempt should be made to perform the division because a run-time error would result. Ifショート サーキット評価の式の使用、2 番目または最初の引数の値に応じて、3 番目の引数のいずれかを評価します。Because the If expression uses short-circuit evaluation, it evaluates either the second or the third argument, depending on the value of the first argument. 最初の引数が true の場合は、除数 0 ではないと 2 番目の引数を評価し、除算を実行しても安全です。If the first argument is true, the divisor is not zero and it is safe to evaluate the second argument and perform the division. 最初の引数が false の場合は、3 番目の引数のみが評価され、0 が返されます。If the first argument is false, only the third argument is evaluated and a 0 is returned. そのため、除数が 0 の場合は行われません、除算とエラーは発生しませんを実行します。Therefore, when the divisor is 0, no attempt is made to perform the division and no error results. ただし、ためIIf使用しないショート サーキット評価、最初の引数が false の場合も、2 番目の引数が評価されます。However, because IIf does not use short-circuit evaluation, the second argument is evaluated even when the first argument is false. これにより、実行時に 0 除算エラーです。This causes a run-time divide-by-zero error.

number = 12

' When the divisor is not 0, both If and IIf return 4.
Dim divisor = 3
Console.WriteLine(If(divisor <> 0, number \ divisor, 0))
Console.WriteLine(IIf(divisor <> 0, number \ divisor, 0))

' When the divisor is 0, IIf causes a run-time error, but If does not.
divisor = 0
Console.WriteLine(If(divisor <> 0, number \ divisor, 0))
' Console.WriteLine(IIf(divisor <> 0, number \ divisor, 0))

演算子が 2 つの引数で呼び出された場合If Operator Called with Two Arguments

1 番目の引数Ifを省略できます。The first argument to If can be omitted. これにより、2 つの引数を使用して呼び出される演算子です。This enables the operator to be called by using only two arguments. 次のリストの適用される場合にのみ、If演算子が 2 つの引数と呼ばれます。The following list applies only when the If operator is called with two arguments.

指定項目Parts

用語Term 定義Definition
argument2 必須。Required. ObjectObject. 参照または null 許容型にする必要があります。Must be a reference or nullable type. 評価され、以外の値に評価された場合に返されるNothingです。Evaluated and returned when it evaluates to anything other than Nothing.
argument3 必須。Required. ObjectObject. 評価されると返される場合argument2に評価されるNothingです。Evaluated and returned if argument2 evaluates to Nothing.

ときに、Boolean引数を省略すると、最初の引数が参照または null 許容型にする必要があります。When the Boolean argument is omitted, the first argument must be a reference or nullable type. 最初の引数が評価された場合Nothing、2 番目の引数の値が返されます。If the first argument evaluates to Nothing, the value of the second argument is returned. それ以外の場合は、最初の引数の値が返されます。In all other cases, the value of the first argument is returned. 次の例では、この評価のしくみを示しています。The following example illustrates how this evaluation works.

' Variable first is a nullable type.
Dim first? As Integer = 3
Dim second As Integer = 6

' Variable first <> Nothing, so its value, 3, is returned.
Console.WriteLine(If(first, second))

second = Nothing
' Variable first <> Nothing, so the value of first is returned again.
Console.WriteLine(If(first, second))

first = Nothing
second = 6
' Variable first = Nothing, so 6 is returned.
Console.WriteLine(If(first, second))

関連項目See Also

IIf
null 許容値型Nullable Value Types
NothingNothing