docs/ecma334/14.9.10.xml

   1 <?xml version="1.0"?>
   2 <clause number="14.9.10" title="The as operator">
   3   <paragraph>The as operator is used to explicitly convert a value to a given reference type using a reference conversion or a boxing conversion. Unlike a cast expression (<hyperlink>14.6.6</hyperlink>), the as operator never throws an exception. Instead, if the indicated conversion is not possible, the resulting value is null. </paragraph>
   4   <paragraph>In an operation of the form e as T, e must be an expression and T must be a reference type. The type of the result is T, and the result is always classified as a value. The operation is evaluated as follows: <list><list_item> If the compile-time type of e is the same as T, the result is simply the value of e. </list_item><list_item> Otherwise, if an implicit reference conversion (<hyperlink>13.1.4</hyperlink>) or boxing conversion (<hyperlink>13.1.5</hyperlink>) exists from the compile-time type of e to T, this conversion is performed and becomes the result of the operation. </list_item><list_item> Otherwise, if an explicit reference conversion (<hyperlink>13.2.3</hyperlink>) exists from the compile-time type of e to T, a dynamic type check is performed: </list_item><list><list_item> If the value of e is null, the result is the value null with the compile-time type T. </list_item><list_item> Otherwise, let R be the run-time type of the instance referenced by e. If R and T are the same type, if R is a reference type and an implicit reference conversion from R to T exists, or if R is a value type and T is an interface type that is implemented by R, the result is the reference given by e with the compile-time type T. </list_item><list_item> Otherwise, the result is the value null with the compile-time type T. </list_item></list><list_item> Otherwise, the indicated conversion is never possible, and a compile-time error occurs. </list_item></list></paragraph>
   5   <paragraph>Note that the as operator only performs reference conversions and boxing conversions. Other conversions, such as user defined conversions, are not possible with the as operator and should instead be performed using cast expressions. </paragraph>
   6 </clause>