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
|
//---------------------------------------------------------------------
// <copyright file="DbInsertCommandTree.cs" company="Microsoft">
// Copyright (c) Microsoft Corporation. All rights reserved.
// </copyright>
//
// @owner Microsoft, Microsoft
// @backupOwner Microsoft
//---------------------------------------------------------------------
using System;
using System.Collections.Generic;
using System.Data.Metadata.Edm;
using System.Data.Common.CommandTrees.Internal;
using System.Data.Common.Utils;
using System.Diagnostics;
using System.Collections.ObjectModel;
using ReadOnlyModificationClauses = System.Collections.ObjectModel.ReadOnlyCollection<System.Data.Common.CommandTrees.DbModificationClause>; // System.Data.Common.ReadOnlyCollection conflicts
namespace System.Data.Common.CommandTrees
{
/// <summary>
/// Represents a single row insert operation expressed as a canonical command tree.
/// When the <see cref="Returning"/> property is set, the command returns a reader; otherwise,
/// it returns a scalar value indicating the number of rows affected.
/// </summary>
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1709:IdentifiersShouldBeCasedCorrectly", MessageId = "Db")]
public sealed class DbInsertCommandTree : DbModificationCommandTree
{
private readonly ReadOnlyModificationClauses _setClauses;
private readonly DbExpression _returning;
internal DbInsertCommandTree(MetadataWorkspace metadata, DataSpace dataSpace, DbExpressionBinding target, ReadOnlyModificationClauses setClauses, DbExpression returning)
: base(metadata, dataSpace, target)
{
EntityUtil.CheckArgumentNull(setClauses, "setClauses");
// returning may be null
this._setClauses = setClauses;
this._returning = returning;
}
/// <summary>
/// Gets set clauses determining values of columns in the inserted row.
/// </summary>
public IList<DbModificationClause> SetClauses
{
get
{
return _setClauses;
}
}
/// <summary>
/// Gets an <see cref="DbExpression"/> that specifies a projection of results to be returned based on the modified rows.
/// If null, indicates no results should be returned from this command.
/// </summary>
/// <remarks>
/// The returning projection includes only the following elements:
/// <list>
/// <item>NewInstance expression</item>
/// <item>Property expression</item>
/// </list>
/// </remarks>
public DbExpression Returning
{
get
{
return _returning;
}
}
internal override DbCommandTreeKind CommandTreeKind
{
get { return DbCommandTreeKind.Insert; }
}
internal override bool HasReader
{
get { return null != Returning; }
}
internal override void DumpStructure(ExpressionDumper dumper)
{
base.DumpStructure(dumper);
dumper.Begin("SetClauses");
foreach (DbModificationClause clause in this.SetClauses)
{
if (null != clause)
{
clause.DumpStructure(dumper);
}
}
dumper.End("SetClauses");
if (null != this.Returning)
{
dumper.Dump(this.Returning, "Returning");
}
}
internal override string PrintTree(ExpressionPrinter printer)
{
return printer.Print(this);
}
}
}
|
