WorksheetFunction.Choose Method

  • Article

Uses Arg1 as the index to return a value from the list of value arguments.

Namespace:  Microsoft.Office.Interop.Excel
Assembly:  Microsoft.Office.Interop.Excel (in Microsoft.Office.Interop.Excel.dll)

Syntax

'Declaration
Function Choose ( _
    Arg1 As Object, _
    Arg2 As Object, _
    Arg3 As Object, _
    Arg4 As Object, _
    Arg5 As Object, _
    Arg6 As Object, _
    Arg7 As Object, _
    Arg8 As Object, _
    Arg9 As Object, _
    Arg10 As Object, _
    Arg11 As Object, _
    Arg12 As Object, _
    Arg13 As Object, _
    Arg14 As Object, _
    Arg15 As Object, _
    Arg16 As Object, _
    Arg17 As Object, _
    Arg18 As Object, _
    Arg19 As Object, _
    Arg20 As Object, _
    Arg21 As Object, _
    Arg22 As Object, _
    Arg23 As Object, _
    Arg24 As Object, _
    Arg25 As Object, _
    Arg26 As Object, _
    Arg27 As Object, _
    Arg28 As Object, _
    Arg29 As Object, _
    Arg30 As Object _
) As Object
'Usage
Dim instance As WorksheetFunction
Dim Arg1 As Object
Dim Arg2 As Object
Dim Arg3 As Object
Dim Arg4 As Object
Dim Arg5 As Object
Dim Arg6 As Object
Dim Arg7 As Object
Dim Arg8 As Object
Dim Arg9 As Object
Dim Arg10 As Object
Dim Arg11 As Object
Dim Arg12 As Object
Dim Arg13 As Object
Dim Arg14 As Object
Dim Arg15 As Object
Dim Arg16 As Object
Dim Arg17 As Object
Dim Arg18 As Object
Dim Arg19 As Object
Dim Arg20 As Object
Dim Arg21 As Object
Dim Arg22 As Object
Dim Arg23 As Object
Dim Arg24 As Object
Dim Arg25 As Object
Dim Arg26 As Object
Dim Arg27 As Object
Dim Arg28 As Object
Dim Arg29 As Object
Dim Arg30 As Object
Dim returnValue As Object

returnValue = instance.Choose(Arg1, Arg2, _
    Arg3, Arg4, Arg5, Arg6, Arg7, Arg8, _
    Arg9, Arg10, Arg11, Arg12, Arg13, Arg14, _
    Arg15, Arg16, Arg17, Arg18, Arg19, _
    Arg20, Arg21, Arg22, Arg23, Arg24, _
    Arg25, Arg26, Arg27, Arg28, Arg29, _
    Arg30)

Object Choose(
    Object Arg1,
    Object Arg2,
    Object Arg3,
    Object Arg4,
    Object Arg5,
    Object Arg6,
    Object Arg7,
    Object Arg8,
    Object Arg9,
    Object Arg10,
    Object Arg11,
    Object Arg12,
    Object Arg13,
    Object Arg14,
    Object Arg15,
    Object Arg16,
    Object Arg17,
    Object Arg18,
    Object Arg19,
    Object Arg20,
    Object Arg21,
    Object Arg22,
    Object Arg23,
    Object Arg24,
    Object Arg25,
    Object Arg26,
    Object Arg27,
    Object Arg28,
    Object Arg29,
    Object Arg30
)

Parameters

  • Arg1
    Type: System.Object

    Specifies which value argument is selected. Arg1 must be a number between 1 and 29, or a formula or reference to a cell containing a number between 1 and 29.

  • Arg2
    Type: System.Object

    1 to 29 value arguments from which Choose selects a value or an action to perform based on Arg1. The arguments can be numbers, cell references, defined names, formulas, functions, or text.

Return Value

Type: System.Object

Remarks

If Arg1 is 1, Choose returns value1; if it is 2, Choose returns value2; and so on.

If Arg1 is less than 1 or greater than the number of the last value in the list, Choose generates an error.

If Arg1 is a fraction, it is truncated to the lowest integer before being used.

If Arg1 is an array, every value is evaluated when Choose is evaluated.

The value arguments to Choose can be range references as well as single values. For example, the formula:

=SUM(Choose(2,A1:A10,B1:B10,C1:C10))

evaluates to:

=SUM(B1:B10)

which then returns a value based on the values in the range B1:B10.

The Choose function is evaluated first, returning the reference B1:B10. The SUM function is then evaluated using B1:B10, the result of the Choose function, as its argument.

See Also

Reference

WorksheetFunction Interface

WorksheetFunction Members

Microsoft.Office.Interop.Excel Namespace