|
//------------------------------------------------------------------------------
// <copyright file="DataColumnMappingCollection.cs" company="Microsoft">
// Copyright (c) Microsoft Corporation. All rights reserved.
// </copyright>
// <owner current="true" primary="true">Microsoft</owner>
// <owner current="true" primary="false">Microsoft</owner>
//------------------------------------------------------------------------------
namespace System.Data.Common {
using System;
using System.Collections;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Diagnostics;
public sealed class DataColumnMappingCollection : MarshalByRefObject, IColumnMappingCollection {
private List<DataColumnMapping> items; // delay creation until AddWithoutEvents, Insert, CopyTo, GetEnumerator
public DataColumnMappingCollection() {
}
// explicit ICollection implementation
bool System.Collections.ICollection.IsSynchronized {
get { return false;}
}
object System.Collections.ICollection.SyncRoot {
get { return this;}
}
// explicit IList implementation
bool System.Collections.IList.IsReadOnly {
get { return false;}
}
bool System.Collections.IList.IsFixedSize {
get { return false;}
}
object System.Collections.IList.this[int index] {
get {
return this[index];
}
set {
ValidateType(value);
this[index] = (DataColumnMapping) value;
}
}
// explicit IColumnMappingCollection implementation
object IColumnMappingCollection.this[string index] {
get {
return this[index];
}
set {
ValidateType(value);
this[index] = (DataColumnMapping) value;
}
}
IColumnMapping IColumnMappingCollection.Add(string sourceColumnName, string dataSetColumnName) {
return Add(sourceColumnName, dataSetColumnName);
}
IColumnMapping IColumnMappingCollection.GetByDataSetColumn(string dataSetColumnName) {
return GetByDataSetColumn(dataSetColumnName);
}
[
Browsable(false),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
ResDescriptionAttribute(Res.DataColumnMappings_Count),
]
public int Count {
get {
return ((null != items) ? items.Count : 0);
}
}
private Type ItemType {
get { return typeof(DataColumnMapping); }
}
[
Browsable(false),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
ResDescriptionAttribute(Res.DataColumnMappings_Item),
]
public DataColumnMapping this[int index] {
get {
RangeCheck(index);
return items[index];
}
set {
RangeCheck(index);
Replace(index, value);
}
}
[
Browsable(false),
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden),
ResDescriptionAttribute(Res.DataColumnMappings_Item),
]
public DataColumnMapping this[string sourceColumn] {
get {
int index = RangeCheck(sourceColumn);
return items[index];
}
set {
int index = RangeCheck(sourceColumn);
Replace(index, value);
}
}
public int Add(object value) {
ValidateType(value);
Add((DataColumnMapping) value);
return Count-1;
}
private DataColumnMapping Add(DataColumnMapping value) {
AddWithoutEvents(value);
return value;
}
public DataColumnMapping Add(string sourceColumn, string dataSetColumn) {
return Add(new DataColumnMapping(sourceColumn, dataSetColumn));
}
public void AddRange(DataColumnMapping[] values) { // V1.0.3300
AddEnumerableRange(values, false);
}
public void AddRange(System.Array values) { // V1.2.3300
AddEnumerableRange(values, false);
}
/*/// <include file='doc\DataColumnMappingCollection.uex' path='docs/doc[@for="DataColumnMappingCollection.AddCloneOfRange"]/*' />
public void AddCloneOfRange(IEnumerable values) {
AddEnumerableRange(values, true);
}*/
private void AddEnumerableRange(IEnumerable values, bool doClone) {
if (null == values) {
throw ADP.ArgumentNull("values");
}
foreach(object value in values) {
ValidateType(value);
}
if (doClone) {
foreach(ICloneable value in values) {
AddWithoutEvents(value.Clone() as DataColumnMapping);
}
}
else {
foreach(DataColumnMapping value in values) {
AddWithoutEvents(value);
}
}
}
private void AddWithoutEvents(DataColumnMapping value) {
Validate(-1, value);
value.Parent = this;
ArrayList().Add(value);
}
// implemented as a method, not as a property because the VS7 debugger
// object browser calls properties to display their value, and we want this delayed
private List<DataColumnMapping> ArrayList() {
if (null == this.items) {
this.items = new List<DataColumnMapping>();
}
return this.items;
}
public void Clear() {
if (0 < Count) {
ClearWithoutEvents();
}
}
private void ClearWithoutEvents() {
if (null != items) {
foreach(DataColumnMapping item in items) {
item.Parent = null;
}
items.Clear();
}
}
public bool Contains(string value) {
return(-1 != IndexOf(value));
}
public bool Contains(object value) {
return(-1 != IndexOf(value));
}
public void CopyTo(Array array, int index) {
((ICollection)ArrayList()).CopyTo(array, index);
}
public void CopyTo(DataColumnMapping[] array, int index) {
ArrayList().CopyTo(array, index);
}
public DataColumnMapping GetByDataSetColumn(string value) {
int index = IndexOfDataSetColumn(value);
if (0 > index) {
throw ADP.ColumnsDataSetColumn(value);
}
return items[index];
}
public IEnumerator GetEnumerator() {
return ArrayList().GetEnumerator();
}
public int IndexOf (object value) {
if (null != value) {
ValidateType(value);
for (int i = 0; i < Count; ++i) {
if (items[i] == value) {
return i;
}
}
}
return -1;
}
public int IndexOf(string sourceColumn) {
if (!ADP.IsEmpty(sourceColumn)) {
int count = Count;
for (int i = 0; i < count; ++i) {
if (0 == ADP.SrcCompare(sourceColumn, items[i].SourceColumn)) {
return i;
}
}
}
return -1;
}
public int IndexOfDataSetColumn(string dataSetColumn) {
if (!ADP.IsEmpty(dataSetColumn)) {
int count = Count;
for (int i = 0; i < count; ++i) {
if ( 0 == ADP.DstCompare(dataSetColumn, items[i].DataSetColumn)) {
return i;
}
}
}
return -1;
}
public void Insert(int index, Object value) {
ValidateType(value);
Insert(index, (DataColumnMapping) value);
}
public void Insert(int index, DataColumnMapping value) {
if (null == value) {
throw ADP.ColumnsAddNullAttempt("value");
}
Validate(-1, value);
value.Parent = this;
ArrayList().Insert(index, value);
}
private void RangeCheck(int index) {
if ((index < 0) || (Count <= index)) {
throw ADP.ColumnsIndexInt32(index, this);
}
}
private int RangeCheck(string sourceColumn) {
int index = IndexOf(sourceColumn);
if (index < 0) {
throw ADP.ColumnsIndexSource(sourceColumn);
}
return index;
}
public void RemoveAt(int index) {
RangeCheck(index);
RemoveIndex(index);
}
public void RemoveAt(string sourceColumn) {
int index = RangeCheck(sourceColumn);
RemoveIndex(index);
}
private void RemoveIndex(int index) {
Debug.Assert((null != items) && (0 <= index) && (index < Count), "RemoveIndex, invalid");
items[index].Parent = null;
items.RemoveAt(index);
}
public void Remove(object value) {
ValidateType(value);
Remove((DataColumnMapping) value);
}
public void Remove (DataColumnMapping value) {
if (null == value) {
throw ADP.ColumnsAddNullAttempt ("value");
}
int index = IndexOf (value);
if (-1 != index) {
RemoveIndex (index);
}
else {
throw ADP.CollectionRemoveInvalidObject(ItemType, this);
}
}
private void Replace(int index, DataColumnMapping newValue) {
Debug.Assert((null != items) && (0 <= index) && (index < Count), "RemoveIndex, invalid");
Validate(index, newValue);
items[index].Parent = null;
newValue.Parent = this;
items[index] = newValue;
}
private void ValidateType(object value) {
if (null == value) {
throw ADP.ColumnsAddNullAttempt("value");
}
else if (!ItemType.IsInstanceOfType(value)) {
throw ADP.NotADataColumnMapping(value);
}
}
private void Validate(int index, DataColumnMapping value) {
if (null == value) {
throw ADP.ColumnsAddNullAttempt("value");
}
if (null != value.Parent) {
if (this != value.Parent) {
throw ADP.ColumnsIsNotParent(this);
}
else if (index != IndexOf(value)) {
throw ADP.ColumnsIsParent(this);
}
}
String name = value.SourceColumn;
if (ADP.IsEmpty(name)) {
index = 1;
do {
name = ADP.SourceColumn + index.ToString(System.Globalization.CultureInfo.InvariantCulture);
index++;
} while (-1 != IndexOf(name));
value.SourceColumn = name;
}
else {
ValidateSourceColumn(index, name);
}
}
internal void ValidateSourceColumn(int index, string value) {
int pindex = IndexOf(value);
if ((-1 != pindex) && (index != pindex)) { // must be non-null and unique
throw ADP.ColumnsUniqueSourceColumn(value);
}
}
[ EditorBrowsableAttribute(EditorBrowsableState.Advanced) ] // MDAC 69508
static public DataColumn GetDataColumn(DataColumnMappingCollection columnMappings, string sourceColumn, Type dataType, DataTable dataTable, MissingMappingAction mappingAction, MissingSchemaAction schemaAction) {
if (null != columnMappings) {
int index = columnMappings.IndexOf(sourceColumn);
if (-1 != index) {
#if DEBUG
if (AdapterSwitches.DataSchema.TraceInfo) {
Debug.WriteLine("mapping match on SourceColumn \"" + sourceColumn + "\"");
}
#endif
return columnMappings.items[index].GetDataColumnBySchemaAction(dataTable, dataType, schemaAction);
}
}
if (ADP.IsEmpty(sourceColumn)) {
throw ADP.InvalidSourceColumn("sourceColumn");
}
switch (mappingAction) {
case MissingMappingAction.Passthrough:
#if DEBUG
if (AdapterSwitches.DataSchema.TraceInfo) {
Debug.WriteLine("mapping passthrough of SourceColumn \"" + sourceColumn + "\"");
}
#endif
return DataColumnMapping.GetDataColumnBySchemaAction(sourceColumn, sourceColumn, dataTable, dataType, schemaAction);
case MissingMappingAction.Ignore:
#if DEBUG
if (AdapterSwitches.DataSchema.TraceWarning) {
Debug.WriteLine("mapping filter of SourceColumn \"" + sourceColumn + "\"");
}
#endif
return null;
case MissingMappingAction.Error:
#if DEBUG
if (AdapterSwitches.DataSchema.TraceError) {
Debug.WriteLine("mapping error on SourceColumn \"" + sourceColumn + "\"");
}
#endif
throw ADP.MissingColumnMapping(sourceColumn);
}
throw ADP.InvalidMissingMappingAction(mappingAction);
}
[ EditorBrowsableAttribute(EditorBrowsableState.Advanced) ] // MDAC 69508
static public DataColumnMapping GetColumnMappingBySchemaAction(DataColumnMappingCollection columnMappings, string sourceColumn, MissingMappingAction mappingAction) {
if (null != columnMappings) {
int index = columnMappings.IndexOf(sourceColumn);
if (-1 != index) {
#if DEBUG
if (AdapterSwitches.DataSchema.TraceInfo) {
Debug.WriteLine("mapping match on SourceColumn \"" + sourceColumn + "\"");
}
#endif
return columnMappings.items[index];
}
}
if (ADP.IsEmpty(sourceColumn)) {
throw ADP.InvalidSourceColumn("sourceColumn");
}
switch (mappingAction) {
case MissingMappingAction.Passthrough:
#if DEBUG
if (AdapterSwitches.DataSchema.TraceInfo) {
Debug.WriteLine("mapping passthrough of SourceColumn \"" + sourceColumn + "\"");
}
#endif
return new DataColumnMapping(sourceColumn, sourceColumn);
case MissingMappingAction.Ignore:
#if DEBUG
if (AdapterSwitches.DataSchema.TraceWarning) {
Debug.WriteLine("mapping filter of SourceColumn \"" + sourceColumn + "\"");
}
#endif
return null;
case MissingMappingAction.Error:
#if DEBUG
if (AdapterSwitches.DataSchema.TraceError) {
Debug.WriteLine("mapping error on SourceColumn \"" + sourceColumn + "\"");
}
#endif
throw ADP.MissingColumnMapping(sourceColumn);
}
throw ADP.InvalidMissingMappingAction(mappingAction);
}
}
}
|