OceanBase
English日本語简体中文
Docs Home
Products
Integrations
Release Notes

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service
OceanBase DatabaseOceanBase Cloud ToolsConnectors and MiddlewareLifecycle Support Policy

OceanBase Connector/NET

V1.3.1
  • What Is OceanBase Connector/NET
    • Introduction to OceanBase Connector/NET
  • 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 string
    • Data Types
      • Overview of data types
    • Command and Parameter
      • Overview
      • ArrayBinding
      • AutoCommit and Transactions
    • Result Set
      • Result set types
    • ORM and Frameworks
      • Use Entity Framework Core
      • Use SqlSugar
      • Use FreeSql
      • Use the ABP Framework
  • Reference Information
    • Common Interfaces
      • Overview of commonly used interfaces
  • Version Release Records
    • OceanBase Connector/NET V1.0.0
    • OceanBase Connector/NET V1.1.0
    • OceanBase Connector/NET V1.2.0
    • OceanBase Connector/NET V1.3.1

Download PDF

Document Feedback
  1. Documentation Center
  2. OceanBase Connector/NET
  3. V1.3.1

Compatibility impact

Last Updated:2026-09-22 03:13:33

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

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
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