1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151
|
/* ****************************************************************************
*
* 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
/// <summary>
/// Represents initializing members of a member of a newly created object.
/// </summary>
/// <remarks>
/// Use the <see cref="M:MemberBind"/> factory methods to create a <see cref="MemberMemberBinding"/>.
/// The value of the <see cref="P:MemberBinding.BindingType"/> property of a <see cref="MemberMemberBinding"/> object is <see cref="MemberBinding"/>.
/// </remarks>
public sealed class MemberMemberBinding : MemberBinding {
ReadOnlyCollection<MemberBinding> _bindings;
internal MemberMemberBinding(MemberInfo member, ReadOnlyCollection<MemberBinding> bindings)
#pragma warning disable 618
: base(MemberBindingType.MemberBinding, member) {
#pragma warning restore 618
_bindings = bindings;
}
/// <summary>
/// Gets the bindings that describe how to initialize the members of a member.
/// </summary>
public ReadOnlyCollection<MemberBinding> Bindings {
get { return _bindings; }
}
/// <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="bindings">The <see cref="Bindings" /> property of the result.</param>
/// <returns>This expression if no children changed, or an expression with the updated children.</returns>
public MemberMemberBinding Update(IEnumerable<MemberBinding> bindings) {
if (bindings == Bindings) {
return this;
}
return Expression.MemberBind(Member, bindings);
}
}
public partial class Expression {
/// <summary>
/// Creates a <see cref="MemberMemberBinding"/> that represents the recursive initialization of members of a field or property.
/// </summary>
/// <param name="member">The <see cref="MemberInfo"/> to set the <see cref="P:MemberBinding.Member"/> property equal to.</param>
/// <param name="bindings">An array of <see cref="MemberBinding"/> objects to use to populate the <see cref="P:MemberMemberBindings.Bindings"/> collection.</param>
/// <returns>A <see cref="MemberMemberBinding"/> that has the <see cref="P:MemberBinding.BindingType"/> property equal to <see cref="MemberBinding"/> and the <see cref="P:MemberBinding.Member"/> and <see cref="P:MemberMemberBindings.Bindings"/> properties set to the specified values.</returns>
public static MemberMemberBinding MemberBind(MemberInfo member, params MemberBinding[] bindings) {
ContractUtils.RequiresNotNull(member, "member");
ContractUtils.RequiresNotNull(bindings, "bindings");
return MemberBind(member, (IEnumerable<MemberBinding>)bindings);
}
/// <summary>
/// Creates a <see cref="MemberMemberBinding"/> that represents the recursive initialization of members of a field or property.
/// </summary>
/// <param name="member">The <see cref="MemberInfo"/> to set the <see cref="P:MemberBinding.Member"/> property equal to.</param>
/// <param name="bindings">An <see cref="IEnumerable{T}"/> that contains <see cref="MemberBinding"/> objects to use to populate the <see cref="P:MemberMemberBindings.Bindings"/> collection.</param>
/// <returns>A <see cref="MemberMemberBinding"/> that has the <see cref="P:MemberBinding.BindingType"/> property equal to <see cref="MemberBinding"/> and the <see cref="P:MemberBinding.Member"/> and <see cref="P:MemberMemberBindings.Bindings"/> properties set to the specified values.</returns>
public static MemberMemberBinding MemberBind(MemberInfo member, IEnumerable<MemberBinding> bindings) {
ContractUtils.RequiresNotNull(member, "member");
ContractUtils.RequiresNotNull(bindings, "bindings");
ReadOnlyCollection<MemberBinding> roBindings = bindings.ToReadOnly();
Type memberType;
ValidateGettableFieldOrPropertyMember(member, out memberType);
ValidateMemberInitArgs(memberType, roBindings);
return new MemberMemberBinding(member, roBindings);
}
/// <summary>
/// Creates a <see cref="MemberMemberBinding"/> that represents the recursive initialization of members of a member that is accessed by using a property accessor method.
/// </summary>
/// <param name="propertyAccessor">The <see cref="MemberInfo"/> that represents a property accessor method.</param>
/// <param name="bindings">An <see cref="IEnumerable{T}"/> that contains <see cref="MemberBinding"/> objects to use to populate the <see cref="P:MemberMemberBindings.Bindings"/> collection.</param>
/// <returns>
/// A <see cref="MemberMemberBinding"/> that has the <see cref="P:MemberBinding.BindingType"/> property equal to <see cref="MemberBinding"/>,
/// the Member property set to the <see cref="PropertyInfo"/> that represents the property accessed in <paramref name="propertyAccessor"/>,
/// and <see cref="P:MemberMemberBindings.Bindings"/> properties set to the specified values.
/// </returns>
public static MemberMemberBinding MemberBind(MethodInfo propertyAccessor, params MemberBinding[] bindings) {
ContractUtils.RequiresNotNull(propertyAccessor, "propertyAccessor");
return MemberBind(GetProperty(propertyAccessor), bindings);
}
/// <summary>
/// Creates a <see cref="MemberMemberBinding"/> that represents the recursive initialization of members of a member that is accessed by using a property accessor method.
/// </summary>
/// <param name="propertyAccessor">The <see cref="MemberInfo"/> that represents a property accessor method.</param>
/// <param name="bindings">An <see cref="IEnumerable{T}"/> that contains <see cref="MemberBinding"/> objects to use to populate the <see cref="P:MemberMemberBindings.Bindings"/> collection.</param>
/// <returns>
/// A <see cref="MemberMemberBinding"/> that has the <see cref="P:MemberBinding.BindingType"/> property equal to <see cref="MemberBinding"/>,
/// the Member property set to the <see cref="PropertyInfo"/> that represents the property accessed in <paramref name="propertyAccessor"/>,
/// and <see cref="P:MemberMemberBindings.Bindings"/> properties set to the specified values.
/// </returns>
public static MemberMemberBinding MemberBind(MethodInfo propertyAccessor, IEnumerable<MemberBinding> 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<MemberBinding> 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);
}
}
}
}
}
|