You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
250 lines
10 KiB
250 lines
10 KiB
5 years ago
|
#if NET20 || NET30 || !NET_4_6
|
||
|
|
||
|
// Copyright (c) Microsoft. All rights reserved.
|
||
|
// Licensed under the MIT license. See LICENSE file in the project root for full license information.
|
||
|
|
||
|
using System.Collections.Generic;
|
||
|
using System.Collections.ObjectModel;
|
||
|
using System.Diagnostics;
|
||
|
using System.Dynamic.Utils;
|
||
|
using LinqInternal.Collections;
|
||
|
using LinqInternal.Core;
|
||
|
|
||
|
namespace System.Linq.Expressions.Reimplement
|
||
|
{
|
||
|
/// <summary>
|
||
|
/// Represents a try/catch/finally/fault block.
|
||
|
///
|
||
|
/// The body is protected by the try block.
|
||
|
/// The handlers consist of a set of <see cref="CatchBlock"/>s that can either be catch or filters.
|
||
|
/// The fault runs if an exception is thrown.
|
||
|
/// The finally runs regardless of how control exits the body.
|
||
|
/// Only one of fault or finally can be supplied.
|
||
|
/// The return type of the try block must match the return type of any associated catch statements.
|
||
|
/// </summary>
|
||
|
[DebuggerTypeProxy(typeof(TryExpressionProxy))]
|
||
|
public sealed class TryExpression : Expression
|
||
|
{
|
||
|
private readonly Type _type;
|
||
|
private readonly Expression _body;
|
||
|
private readonly ReadOnlyCollection<CatchBlock> _handlers;
|
||
|
private readonly Expression _finally;
|
||
|
private readonly Expression _fault;
|
||
|
|
||
|
internal TryExpression(Type type, Expression body, Expression @finally, Expression fault, ReadOnlyCollection<CatchBlock> handlers)
|
||
|
{
|
||
|
_type = type;
|
||
|
_body = body;
|
||
|
_handlers = handlers;
|
||
|
_finally = @finally;
|
||
|
_fault = fault;
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Gets the static type of the expression that this <see cref="Expression" /> represents. (Inherited from <see cref="Expression"/>.)
|
||
|
/// </summary>
|
||
|
/// <returns>The <see cref="Type"/> that represents the static type of the expression.</returns>
|
||
|
public override Type Type
|
||
|
{
|
||
|
get { return _type; }
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Returns the node type of this <see cref="Expression" />. (Inherited from <see cref="Expression" />.)
|
||
|
/// </summary>
|
||
|
/// <returns>The <see cref="ExpressionType"/> that represents this expression.</returns>
|
||
|
public override ExpressionType NodeType
|
||
|
{
|
||
|
get { return ExpressionType.Try; }
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Gets the <see cref="Expression"/> representing the body of the try block.
|
||
|
/// </summary>
|
||
|
public Expression Body
|
||
|
{
|
||
|
get { return _body; }
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Gets the collection of <see cref="CatchBlock"/>s associated with the try block.
|
||
|
/// </summary>
|
||
|
public ReadOnlyCollection<CatchBlock> Handlers
|
||
|
{
|
||
|
get { return _handlers; }
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Gets the <see cref="Expression"/> representing the finally block.
|
||
|
/// </summary>
|
||
|
public Expression Finally
|
||
|
{
|
||
|
get { return _finally; }
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Gets the <see cref="Expression"/> representing the fault block.
|
||
|
/// </summary>
|
||
|
public Expression Fault
|
||
|
{
|
||
|
get { return _fault; }
|
||
|
}
|
||
|
|
||
|
protected internal override Expression Accept(ExpressionVisitor visitor)
|
||
|
{
|
||
|
return visitor.VisitTry(this);
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Creates a new expression that is like this one, but using the
|
||
|
/// supplied children. If all of the children are the same, it will
|
||
|
/// return this expression.
|
||
|
/// </summary>
|
||
|
/// <param name="body">The <see cref="Body" /> property of the result.</param>
|
||
|
/// <param name="handlers">The <see cref="Handlers" /> property of the result.</param>
|
||
|
/// <param name="finally">The <see cref="Finally" /> property of the result.</param>
|
||
|
/// <param name="fault">The <see cref="Fault" /> property of the result.</param>
|
||
|
/// <returns>This expression if no children changed, or an expression with the updated children.</returns>
|
||
|
public TryExpression Update(Expression body, IEnumerable<CatchBlock> handlers, Expression @finally, Expression fault)
|
||
|
{
|
||
|
if (body == Body && handlers == Handlers && @finally == Finally && fault == Fault)
|
||
|
{
|
||
|
return this;
|
||
|
}
|
||
|
return MakeTry(Type, body, @finally, fault, handlers);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
public partial class Expression
|
||
|
{
|
||
|
/// <summary>
|
||
|
/// Creates a <see cref="TryExpression"/> representing a try block with a fault block and no catch statements.
|
||
|
/// </summary>
|
||
|
/// <param name="body">The body of the try block.</param>
|
||
|
/// <param name="fault">The body of the fault block.</param>
|
||
|
/// <returns>The created <see cref="TryExpression"/>.</returns>
|
||
|
public static TryExpression TryFault(Expression body, Expression fault)
|
||
|
{
|
||
|
return MakeTry(null, body, null, fault, null);
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Creates a <see cref="TryExpression"/> representing a try block with a finally block and no catch statements.
|
||
|
/// </summary>
|
||
|
/// <param name="body">The body of the try block.</param>
|
||
|
/// <param name="finally">The body of the finally block.</param>
|
||
|
/// <returns>The created <see cref="TryExpression"/>.</returns>
|
||
|
public static TryExpression TryFinally(Expression body, Expression @finally)
|
||
|
{
|
||
|
return MakeTry(null, body, @finally, null, null);
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Creates a <see cref="TryExpression"/> representing a try block with any number of catch statements and neither a fault nor finally block.
|
||
|
/// </summary>
|
||
|
/// <param name="body">The body of the try block.</param>
|
||
|
/// <param name="handlers">The array of zero or more <see cref="CatchBlock"/>s representing the catch statements to be associated with the try block.</param>
|
||
|
/// <returns>The created <see cref="TryExpression"/>.</returns>
|
||
|
public static TryExpression TryCatch(Expression body, params CatchBlock[] handlers)
|
||
|
{
|
||
|
return MakeTry(null, body, null, null, handlers);
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Creates a <see cref="TryExpression"/> representing a try block with any number of catch statements and a finally block.
|
||
|
/// </summary>
|
||
|
/// <param name="body">The body of the try block.</param>
|
||
|
/// <param name="finally">The body of the finally block.</param>
|
||
|
/// <param name="handlers">The array of zero or more <see cref="CatchBlock"/>s representing the catch statements to be associated with the try block.</param>
|
||
|
/// <returns>The created <see cref="TryExpression"/>.</returns>
|
||
|
public static TryExpression TryCatchFinally(Expression body, Expression @finally, params CatchBlock[] handlers)
|
||
|
{
|
||
|
return MakeTry(null, body, @finally, null, handlers);
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Creates a <see cref="TryExpression"/> representing a try block with the specified elements.
|
||
|
/// </summary>
|
||
|
/// <param name="type">The result type of the try expression. If null, body and all handlers must have identical type.</param>
|
||
|
/// <param name="body">The body of the try block.</param>
|
||
|
/// <param name="finally">The body of the finally block. Pass null if the try block has no finally block associated with it.</param>
|
||
|
/// <param name="fault">The body of the t block. Pass null if the try block has no fault block associated with it.</param>
|
||
|
/// <param name="handlers">A collection of <see cref="CatchBlock"/>s representing the catch statements to be associated with the try block.</param>
|
||
|
/// <returns>The created <see cref="TryExpression"/>.</returns>
|
||
|
public static TryExpression MakeTry(Type type, Expression body, Expression @finally, Expression fault, IEnumerable<CatchBlock> handlers)
|
||
|
{
|
||
|
RequiresCanRead(body, "body");
|
||
|
|
||
|
var @catch = handlers.ToReadOnly();
|
||
|
ContractUtils.RequiresNotNullItems(@catch, "handlers");
|
||
|
ValidateTryAndCatchHaveSameType(type, body, @catch);
|
||
|
|
||
|
if (fault != null)
|
||
|
{
|
||
|
if (@finally != null || @catch.Count > 0)
|
||
|
{
|
||
|
throw Error.FaultCannotHaveCatchOrFinally();
|
||
|
}
|
||
|
RequiresCanRead(fault, "fault");
|
||
|
}
|
||
|
else if (@finally != null)
|
||
|
{
|
||
|
RequiresCanRead(@finally, "finally");
|
||
|
}
|
||
|
else if (@catch.Count == 0)
|
||
|
{
|
||
|
throw Error.TryMustHaveCatchFinallyOrFault();
|
||
|
}
|
||
|
|
||
|
return new TryExpression(type ?? body.Type, body, @finally, fault, @catch);
|
||
|
}
|
||
|
|
||
|
//Validate that the body of the try expression must have the same type as the body of every try block.
|
||
|
private static void ValidateTryAndCatchHaveSameType(Type type, Expression tryBody, ReadOnlyCollection<CatchBlock> handlers)
|
||
|
{
|
||
|
// Type unification ... all parts must be reference assignable to "type"
|
||
|
if (type != null)
|
||
|
{
|
||
|
if (type != typeof(void))
|
||
|
{
|
||
|
if (!TypeHelper.AreReferenceAssignable(type, tryBody.Type))
|
||
|
{
|
||
|
throw Error.ArgumentTypesMustMatch();
|
||
|
}
|
||
|
foreach (var cb in handlers)
|
||
|
{
|
||
|
if (!TypeHelper.AreReferenceAssignable(type, cb.Body.Type))
|
||
|
{
|
||
|
throw Error.ArgumentTypesMustMatch();
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
else if (tryBody == null || tryBody.Type == typeof(void))
|
||
|
{
|
||
|
//The body of every try block must be null or have void type.
|
||
|
foreach (var cb in handlers)
|
||
|
{
|
||
|
if (cb.Body != null && cb.Body.Type != typeof(void))
|
||
|
{
|
||
|
throw Error.BodyOfCatchMustHaveSameTypeAsBodyOfTry();
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
//Body of every catch must have the same type of body of try.
|
||
|
type = tryBody.Type;
|
||
|
foreach (var cb in handlers)
|
||
|
{
|
||
|
if (cb.Body == null || cb.Body.Type != type)
|
||
|
{
|
||
|
throw Error.BodyOfCatchMustHaveSameTypeAsBodyOfTry();
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
#endif
|