Dreamine.Database.SqlServer.SqlServerDatabaseProvider 클래스 참조

더 자세히 ...

Dreamine.Database.SqlServer.SqlServerDatabaseProvider에 대한 상속 다이어그램 :

Dreamine.Database.SqlServer.SqlServerDatabaseProvider에 대한 협력 다이어그램:

Public 멤버 함수
	SqlServerDatabaseProvider (string connectionString)
override void	EnsureDatabaseExists ()
override async Task	EnsureDatabaseExistsAsync (CancellationToken cancellationToken=default)
override bool	IsTableExists (string tableName)
override async Task< bool >	IsTableExistsAsync (string tableName, CancellationToken cancellationToken=default)

Protected 멤버 함수
override IDbConnection	CreateConnection ()
override string	QuoteIdentifier (string identifier)
override string	BuildCreateTableSql (DatabaseEntityMap map)
override string	GetSqlType (DatabasePropertyMap property)

속성
override DatabaseProviderKind	Kind [get]

정적 Private 멤버 함수
static string	EscapeSqlLiteral (string value)

상세한 설명

SQL Server용 Dreamine 데이터베이스 공급자 구현을 제공합니다.

SqlServerDatabaseProvider.cs 파일의 17 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

SqlServerDatabaseProvider()

Dreamine.Database.SqlServer.SqlServerDatabaseProvider.SqlServerDatabaseProvider ( string connectionString )

inline

지정한 연결 문자열로 SqlServerDatabaseProvider의 새 인스턴스를 초기화합니다.

매개변수

connectionString

SQL Server 연결 문자열입니다.

예외

ArgumentNullException	connectionString 이 null인 경우 발생합니다.
ArgumentException	connectionString 이 비어 있거나 공백인 경우 발생합니다.

SqlServerDatabaseProvider.cs 파일의 51 번째 라인에서 정의되었습니다.

        : base(connectionString)
    {
    }

멤버 함수 문서화

BuildCreateTableSql()

override string Dreamine.Database.SqlServer.SqlServerDatabaseProvider.BuildCreateTableSql ( DatabaseEntityMap map )

inlineprotected

IDENTITY 키를 지원하는 SQL Server CREATE TABLE SQL을 만듭니다.

매개변수

map	테이블 엔터티 매핑입니다.

반환값

조건부 SQL Server CREATE TABLE SQL입니다.

SqlServerDatabaseProvider.cs 파일의 353 번째 라인에서 정의되었습니다.

    {
        var columns = map.Properties.Select(property =>
        {
            var sql = $"{QuoteIdentifier(property.ColumnName)} {GetSqlType(property)}";
            if (property.IsKey)
            {
                sql += property.IsGenerated ? " IDENTITY(1,1) PRIMARY KEY" : " PRIMARY KEY";
            }
 
            return sql;
        });
 
        return $"""
            IF OBJECT_ID(N'{map.TableName}', N'U') IS NULL
            CREATE TABLE {QuoteIdentifier(map.TableName)} ({string.Join(", ", columns)})
            """;
    }

CreateConnection()

override IDbConnection Dreamine.Database.SqlServer.SqlServerDatabaseProvider.CreateConnection ( )

inlineprotected

구성된 연결 문자열을 사용하는 새 SQL Server 연결을 만듭니다.

반환값

닫힌 SQL Server 연결입니다.

SqlServerDatabaseProvider.cs 파일의 278 번째 라인에서 정의되었습니다.

    {
        return new SqlConnection(ConnectionString);
    }

EnsureDatabaseExists()

override void Dreamine.Database.SqlServer.SqlServerDatabaseProvider.EnsureDatabaseExists ( )

inline

연결 문자열에 지정된 SQL Server 데이터베이스가 없으면 생성합니다.

SqlServerDatabaseProvider.cs 파일의 74 번째 라인에서 정의되었습니다.

    {
        var builder = new SqlConnectionStringBuilder(ConnectionString);
        var databaseName = builder.InitialCatalog;
        if (string.IsNullOrWhiteSpace(databaseName))
        {
            base.EnsureDatabaseExists();
            return;
        }
 
        builder.InitialCatalog = "master";
 
        using var connection = new SqlConnection(builder.ConnectionString);
        connection.Open();
 
        using var command = connection.CreateCommand();
        command.CommandText = $"""
            IF DB_ID(N'{EscapeSqlLiteral(databaseName)}') IS NULL
            CREATE DATABASE {QuoteIdentifier(databaseName)}
            """;
        command.ExecuteNonQuery();
    }

EnsureDatabaseExistsAsync()

override async Task Dreamine.Database.SqlServer.SqlServerDatabaseProvider.EnsureDatabaseExistsAsync ( CancellationToken cancellationToken = default )

inline

연결 문자열에 지정된 SQL Server 데이터베이스가 없으면 비동기적으로 생성합니다.

매개변수

cancellationToken

작업 취소 토큰입니다.

반환값

데이터베이스 확인 및 생성 작업입니다.

SqlServerDatabaseProvider.cs 파일의 121 번째 라인에서 정의되었습니다.

    {
        var builder = new SqlConnectionStringBuilder(ConnectionString);
        var databaseName = builder.InitialCatalog;
        if (string.IsNullOrWhiteSpace(databaseName))
        {
            await base.EnsureDatabaseExistsAsync(cancellationToken).ConfigureAwait(false);
            return;
        }
 
        builder.InitialCatalog = "master";
 
        await using var connection = new SqlConnection(builder.ConnectionString);
        await connection.OpenAsync(cancellationToken).ConfigureAwait(false);
 
        await using var command = connection.CreateCommand();
        command.CommandText = $"""
            IF DB_ID(N'{EscapeSqlLiteral(databaseName)}') IS NULL
            CREATE DATABASE {QuoteIdentifier(databaseName)}
            """;
        await command.ExecuteNonQueryAsync(cancellationToken).ConfigureAwait(false);
    }

EscapeSqlLiteral()

string Dreamine.Database.SqlServer.SqlServerDatabaseProvider.EscapeSqlLiteral ( string value )

inlinestaticprivate

SQL 문자열 리터럴에 포함될 작은따옴표를 이스케이프합니다.

매개변수

value

이스케이프할 값입니다.

반환값

작은따옴표가 이스케이프된 값입니다.

SqlServerDatabaseProvider.cs 파일의 472 번째 라인에서 정의되었습니다.

    {
        return value.Replace("'", "''", StringComparison.Ordinal);
    }

GetSqlType()

override string Dreamine.Database.SqlServer.SqlServerDatabaseProvider.GetSqlType ( DatabasePropertyMap property )

inlineprotected

CLR 속성 형식을 대응하는 SQL Server 열 형식으로 변환합니다.

매개변수

property

변환할 속성 매핑입니다.

반환값

SQL Server 열 형식 선언입니다.

SqlServerDatabaseProvider.cs 파일의 396 번째 라인에서 정의되었습니다.

    {
        var type = property.PropertyType;
 
        if (type == typeof(bool))
        {
            return "BIT";
        }
 
        if (type == typeof(byte) || type == typeof(short))
        {
            return "SMALLINT";
        }
 
        if (type == typeof(int))
        {
            return "INT";
        }
 
        if (type == typeof(long))
        {
            return "BIGINT";
        }
 
        if (type == typeof(float))
        {
            return "REAL";
        }
 
        if (type == typeof(double))
        {
            return "FLOAT";
        }
 
        if (type == typeof(decimal))
        {
            return "DECIMAL(18, 4)";
        }
 
        if (type == typeof(DateTime) || type == typeof(DateTimeOffset))
        {
            return "DATETIME2";
        }
 
        if (type == typeof(byte[]))
        {
            return "VARBINARY(MAX)";
        }
 
        return "NVARCHAR(MAX)";
    }

IsTableExists()

override bool Dreamine.Database.SqlServer.SqlServerDatabaseProvider.IsTableExists ( string tableName )

inline

현재 SQL Server 데이터베이스에 지정한 테이블이 존재하는지 확인합니다.

매개변수

tableName

확인할 테이블 이름입니다.

반환값

테이블 존재 여부입니다.

예외

ArgumentNullException	tableName 이 null인 경우 발생합니다.
ArgumentException	tableName 이 비어 있거나 공백인 경우 발생합니다.

SqlServerDatabaseProvider.cs 파일의 184 번째 라인에서 정의되었습니다.

    {
        ArgumentException.ThrowIfNullOrWhiteSpace(tableName);
 
        const string sql = """
            SELECT COUNT(1)
            FROM INFORMATION_SCHEMA.TABLES
            WHERE TABLE_NAME = @TableName
            """;
 
        return ExecuteScalar<int>(sql, new { TableName = tableName }) > 0;
    }

IsTableExistsAsync()

override async Task< bool > Dreamine.Database.SqlServer.SqlServerDatabaseProvider.IsTableExistsAsync ( string tableName, CancellationToken cancellationToken = default )

inline

현재 SQL Server 데이터베이스에 지정한 테이블이 존재하는지 비동기적으로 확인합니다.

매개변수

tableName	확인할 테이블 이름입니다.
cancellationToken	조회 취소 토큰입니다.

반환값

테이블 존재 여부를 결과로 제공하는 작업입니다.

예외

ArgumentNullException	tableName 이 null인 경우 발생합니다.
ArgumentException	tableName 이 비어 있거나 공백인 경우 발생합니다.

SqlServerDatabaseProvider.cs 파일의 245 번째 라인에서 정의되었습니다.

    {
        ArgumentException.ThrowIfNullOrWhiteSpace(tableName);
 
        const string sql = """
            SELECT COUNT(1)
            FROM INFORMATION_SCHEMA.TABLES
            WHERE TABLE_NAME = @TableName
            """;
 
        var count = await ExecuteScalarAsync<int>(sql, new { TableName = tableName }, cancellationToken)
            .ConfigureAwait(false);
        return count > 0;
    }

QuoteIdentifier()

override string Dreamine.Database.SqlServer.SqlServerDatabaseProvider.QuoteIdentifier ( string identifier )

inlineprotected

SQL Server 대괄호 문법으로 식별자를 안전하게 인용합니다.

매개변수

identifier

인용할 식별자입니다.

반환값

이스케이프하고 인용한 식별자입니다.

예외

ArgumentNullException	identifier 가 null인 경우 발생합니다.
ArgumentException	identifier 가 비어 있거나 공백인 경우 발생합니다.

SqlServerDatabaseProvider.cs 파일의 323 번째 라인에서 정의되었습니다.

    {
        ArgumentException.ThrowIfNullOrWhiteSpace(identifier);
        return "[" + identifier.Replace("]", "]]", StringComparison.Ordinal) + "]";
    }

속성 문서화

Kind

override DatabaseProviderKind Dreamine.Database.SqlServer.SqlServerDatabaseProvider.Kind

get

SQL Server 공급자 종류를 가져옵니다.

SqlServerDatabaseProvider.cs 파일의 64 번째 라인에서 정의되었습니다.

---

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

• SqlServerDatabaseProvider.cs