OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

OceanBase Connector/NET

V1.1.0

  • What Is OceanBase Connector/NET
    • Introduction
  • Install and Connect
    • Installation process
    • Test the connection
    • Package reference and usage
    • Compatibility impact
  • User Guide
    • Quick Start
      • Complete example
    • Connection Strings and Data Source
      • Connection strings
    • Data Types
      • Overview of data types
    • Command and Parameter
      • Overview
    • Result Set
      • Supported result set types
    • ORM and Frameworks
      • Use Entity Framework Core
      • Use SqlSugar
      • Use FreeSql
  • Reference Information
    • Common Interfaces
      • Overview of commonly used interfaces
  • Version Release Records
    • OceanBase Connector/NET V1.0.0
    • OceanBase Connector/NET V1.1.0

Download PDF

Introduction Installation process Test the connection Package reference and usage Compatibility impact Complete example Connection strings Overview of data types Overview Supported result set types Use Entity Framework Core Use SqlSugar Use FreeSql Overview of commonly used interfaces OceanBase Connector/NET V1.0.0 OceanBase Connector/NET V1.1.0
OceanBase logo

The Unified Distributed Database for the AI Era.

Follow Us
Products
OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
Resources
DocsBlogLive DemosTraining & Certification
Company
About OceanBaseTrust CenterLegalPartnerContact Us
Follow Us

© OceanBase 2026. All rights reserved

Cloud Service AgreementPrivacy PolicySecurity
Contact Us
Document Feedback
  1. Documentation Center
  2. OceanBase Connector/NET
  3. V1.1.0
iconOceanBase Connector/NET
V 1.1.0
  • V 1.1.0
  • V 1.0.0

Compatibility impact

Last Updated:2026-04-28 03:38:03  Updated
share
What is on this page
Change details
Examples
Common errors in business code
1. using statement errors
2. Type or enum name errors
3. Reflection or string configuration errors at runtime
Troubleshooting and modification steps

folded

share

Starting from 1.1.0, the OceanBase.ManagedDataAccess driver unifies the external namespace from Oceanbase to OceanBase.

This is a case-sensitive change. In C#, inconsistent namespace casing can lead to compilation failures.

Change details

  • Old namespace: Oceanbase
  • New namespace: OceanBase

Examples

Before After
using Oceanbase; using OceanBase;
Oceanbase.OracleConnection OceanBase.OracleConnection
Oceanbase.OracleCommand OceanBase.OracleCommand
Oceanbase.OracleParameter OceanBase.OracleParameter
Oceanbase.OracleDbType OceanBase.OracleDbType

Common errors in business code

After upgrading to V1.1.0, if your business code still uses the Oceanbase namespace, you may encounter the following errors.

1. using statement errors

Common compilation errors:

  • CS0246: The type or namespace name Oceanbase could not be found
  • CS0234: The type or namespace name XXX does not exist in the namespace Oceanbase

Example (error):

using Oceanbase;
using Oceanbase.EntityFrameworkCore;

Should be changed to:

using OceanBase;
using OceanBase.EntityFrameworkCore;

2. Type or enum name errors

If your code directly uses the fully qualified name, it will also fail to compile.

Example (error):

var conn = new Oceanbase.OracleConnection(connectionString);
var cmd = new Oceanbase.OracleCommand(sql, conn);
var type = Oceanbase.OracleDbType.Varchar2;

Should be changed to:

var conn = new OceanBase.OracleConnection(connectionString);
var cmd = new OceanBase.OracleCommand(sql, conn);
var type = OceanBase.OracleDbType.Varchar2;

3. Reflection or string configuration errors at runtime

If your business code stores type names as strings, you also need to update them. Otherwise, you may encounter issues such as Type.GetType(...) returning null or dynamic loading failures.

Example (error):

Oceanbase.OracleConnection

Should be changed to:

OceanBase.OracleConnection

Troubleshooting and modification steps

We recommend that you follow these steps to troubleshoot and modify your code.

  1. Search globally for Oceanbase (case-sensitive) in your business code repository.
  2. Replace all namespace references with OceanBase.
  3. Check the following areas carefully:
    • using statements
    • Fully qualified type names
    • Fully qualified enum names
    • global using
    • typeof(...)
    • Reflection strings and configuration strings (including JSON, XML, and database configuration tables)

Note

  • This change mainly focuses on **normalizing the case sensitivity of namespaces**.
  • Do not change your business logic based on this change. The NuGet package references should remain as they are.
  • If you encounter compilation errors indicating that a type or namespace does not exist after the upgrade, check if there are any remaining references to the old `Oceanbase` namespace that have not been replaced.

Previous topic

Package reference and usage
Last

Next topic

Complete example
Next
What is on this page
Change details
Examples
Common errors in business code
1. using statement errors
2. Type or enum name errors
3. Reflection or string configuration errors at runtime
Troubleshooting and modification steps