109 lines
3.7 KiB
C#
109 lines
3.7 KiB
C#
//---------------------------------------------------------------------
|
|
// <copyright file="DbInsertCommandTree.cs" company="Microsoft">
|
|
// Copyright (c) Microsoft Corporation. All rights reserved.
|
|
// </copyright>
|
|
//
|
|
// @owner [....], [....]
|
|
// @backupOwner [....]
|
|
//---------------------------------------------------------------------
|
|
|
|
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);
|
|
}
|
|
}
|
|
}
|