/* ****************************************************************************
*
* Copyright (c) Microsoft Corporation.
*
* This source code is subject to terms and conditions of the Apache License, Version 2.0. A
* copy of the license can be found in the License.html file at the root of this distribution. If
* you cannot locate the Apache License, Version 2.0, please send an email to
* dlr@microsoft.com. By using this source code in any fashion, you are agreeing to be bound
* by the terms of the Apache License, Version 2.0.
*
* You must not remove this notice, or any other, from this software.
*
*
* ***************************************************************************/
using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Dynamic.Utils;
using System.Reflection;
#if !FEATURE_CORE_DLR
namespace Microsoft.Scripting.Ast {
#else
namespace System.Linq.Expressions {
#endif
///
/// Represents initializing members of a member of a newly created object.
///
///
/// Use the factory methods to create a .
/// The value of the property of a object is .
///
public sealed class MemberMemberBinding : MemberBinding {
ReadOnlyCollection _bindings;
internal MemberMemberBinding(MemberInfo member, ReadOnlyCollection bindings)
#pragma warning disable 618
: base(MemberBindingType.MemberBinding, member) {
#pragma warning restore 618
_bindings = bindings;
}
///
/// Gets the bindings that describe how to initialize the members of a member.
///
public ReadOnlyCollection Bindings {
get { return _bindings; }
}
///
/// 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.
///
/// The property of the result.
/// This expression if no children changed, or an expression with the updated children.
public MemberMemberBinding Update(IEnumerable bindings) {
if (bindings == Bindings) {
return this;
}
return Expression.MemberBind(Member, bindings);
}
}
public partial class Expression {
///
/// Creates a that represents the recursive initialization of members of a field or property.
///
/// The to set the property equal to.
/// An array of objects to use to populate the collection.
/// A that has the property equal to and the and properties set to the specified values.
public static MemberMemberBinding MemberBind(MemberInfo member, params MemberBinding[] bindings) {
ContractUtils.RequiresNotNull(member, "member");
ContractUtils.RequiresNotNull(bindings, "bindings");
return MemberBind(member, (IEnumerable)bindings);
}
///
/// Creates a that represents the recursive initialization of members of a field or property.
///
/// The to set the property equal to.
/// An that contains objects to use to populate the collection.
/// A that has the property equal to and the and properties set to the specified values.
public static MemberMemberBinding MemberBind(MemberInfo member, IEnumerable bindings) {
ContractUtils.RequiresNotNull(member, "member");
ContractUtils.RequiresNotNull(bindings, "bindings");
ReadOnlyCollection roBindings = bindings.ToReadOnly();
Type memberType;
ValidateGettableFieldOrPropertyMember(member, out memberType);
ValidateMemberInitArgs(memberType, roBindings);
return new MemberMemberBinding(member, roBindings);
}
///
/// Creates a that represents the recursive initialization of members of a member that is accessed by using a property accessor method.
///
/// The that represents a property accessor method.
/// An that contains objects to use to populate the collection.
///
/// A that has the property equal to ,
/// the Member property set to the that represents the property accessed in ,
/// and properties set to the specified values.
///
public static MemberMemberBinding MemberBind(MethodInfo propertyAccessor, params MemberBinding[] bindings) {
ContractUtils.RequiresNotNull(propertyAccessor, "propertyAccessor");
return MemberBind(GetProperty(propertyAccessor), bindings);
}
///
/// Creates a that represents the recursive initialization of members of a member that is accessed by using a property accessor method.
///
/// The that represents a property accessor method.
/// An that contains objects to use to populate the collection.
///
/// A that has the property equal to ,
/// the Member property set to the that represents the property accessed in ,
/// and properties set to the specified values.
///
public static MemberMemberBinding MemberBind(MethodInfo propertyAccessor, IEnumerable bindings) {
ContractUtils.RequiresNotNull(propertyAccessor, "propertyAccessor");
return MemberBind(GetProperty(propertyAccessor), bindings);
}
private static void ValidateGettableFieldOrPropertyMember(MemberInfo member, out Type memberType) {
FieldInfo fi = member as FieldInfo;
if (fi == null) {
PropertyInfo pi = member as PropertyInfo;
if (pi == null) {
throw Error.ArgumentMustBeFieldInfoOrPropertInfo();
}
if (!pi.CanRead) {
throw Error.PropertyDoesNotHaveGetter(pi);
}
memberType = pi.PropertyType;
} else {
memberType = fi.FieldType;
}
}
private static void ValidateMemberInitArgs(Type type, ReadOnlyCollection bindings) {
for (int i = 0, n = bindings.Count; i < n; i++) {
MemberBinding b = bindings[i];
ContractUtils.RequiresNotNull(b, "bindings");
if (!b.Member.DeclaringType.IsAssignableFrom(type)) {
throw Error.NotAMemberOfType(b.Member.Name, type);
}
}
}
}
}